Genesys Cloud - Developer Announcements!

Summary

TheAgent Utilizations Aggregates API, currently in Preview, is being updated to remove support for the topN and bottomN query types.

The following changes are being introduced:

• Support for topN and bottomN query types is being removed.

• The queryType, sortMetric, and limit fields are being removed from the request contract. Requests containing these fields will be rejected.

• userId is now required as a groupBy dimension.

• The query type will default to groupBy, which is now the only supported query type.

Effective Date

Monday, August 24, 2026

Details

The metric calculation for this use case has been updated. These changes simplify the API contract and align the supported query model with the updated calculation approach.

Customer Impact

These endpoints are currently in Preview. No production workloads are affected.

Customers testing these Preview APIs must update their request payloads to:

• Remove queryType, sortMetric, and limit, if present.

• Include userId in the groupBy field.

Requests that continue to include the removed fields or do not include userId as a groupBy dimension will be rejected

Impacted Resources

POST /api/v2/analytics/agentutilizations/aggregates/jobs

POST /api/v2/analytics/agentutilizations/aggregates/query

Issue References

AR-13495

AR-13497

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.

Thank you for the post.