Genesys Cloud - Developer Announcements!

Summary

The change introduces date range limits for creating or copying forecasts and schedules through the API thereby:

• Ensuring platform stability is crucial, as the APIs currently lack limits, allowing users to perform forecasts and schedule operations without restrictions on the start date range in the past or future.
• Allows APIs to be consistent with UI date range limits

Here’s what’s changing:

• Forecasts Start Date: Can start up to 104 weeks (2 years) in the future or up to 26 weeks (6 months) in the past.
• Forecasts End Date: Cannot be more than 130 weeks from the current date
• Schedules : Can start up to 104 weeks in the future. Cannot copy the schedule if the end date of the newly copied forecast is more than 130 weeks in future

Effective Date

Monday, December 15, 2025

Details

Previously, the API allowed forecasts or schedules to be created for any date — even far beyond what the UI permitted. This mismatch could lead to unexpected behavior, data inconsistencies, or system errors when managing schedules or forecasts across the platform. Now, the system will block any API requests that go beyond these limits. The change is being made to ensure platform stability and consistency between the API and the UI.

Customer Impact

For customers, the main impact is on API-based automations or integrations that create or copy forecasts and schedules.

Here’s what to expect:

• Blocked requests: Any API calls that try to create forecasts or schedules outside the new limits mentioned above will fail once the change takes effect.

• Required updates: Customers using custom scripts or integrations will need to review and adjust date logic to keep start and end dates within the new range.

• Operational continuity: Without these updates, automated processes could stop working or throw errors, potentially disrupting forecast and schedule operations.

Impacted Resources

Short-Term Forecast APIs

/api/v2/workforcemanagement/businessunits/{businessUnitId}/weeks/{weekDateId}/shorttermforecasts/generate /api/v2/workforcemanagement/businessunits/{businessUnitId}/weeks/{weekDateId}/shorttermforecasts/import /api/v2/workforcemanagement/businessunits/{businessUnitId}/weeks/{weekDateId}/shorttermforecasts/{forecastId}/copy

Non breaking change but should follow the new date limits

/api/v2/workforcemanagement/businessunits/{businessUnitId}/weeks/{weekDateId}/shorttermforecasts/import/uploadurl

Schedule APIs

/api/v2/workforcemanagement/businessunits/{businessUnitId}/weeks/{weekId}/schedules /api/v2/workforcemanagement/businessunits/{businessUnitId}/weeks/{weekId}/schedules/generate /api/v2/workforcemanagement/businessunits/{businessUnitId}/weeks/{weekId}/schedules/import /api/v2/workforcemanagement/businessunits/{businessUnitId}/weeks/{weekId}/schedules/{scheduleId}/copy

Non breaking change but should follow the new date limits

/api/v2/workforcemanagement/businessunits/{businessUnitId}/weeks/{weekId}/schedules/import/uploadurl

Issue References

WEM-1394

Contacts

Please reply to this announcement with any questions. This helps the wider developer community benefit from the discussion. We encourage you to use this thread before contacting the designated person directly. Thank you for your understanding.