Analytics Conversation Detail Endpoint API query interval change

Announced on Takes effect Allowlist ends
September 9, 2020 December 16, 2020 March 1, 2023

On December 16, 2020, Genesys changed the Analytics Conversation Detail Endpoint (/api/v2/analytics/conversations/details/query) to allow querying for interval start dates up to 558 days in the past, including today. Genesys recommends that you use the Analytics Conversation Detail Async Endpoint (/api/v2/analytics/conversations/details/jobs) for historical queries. For recent data, Genesys recommends that you use the notifications service when possible. 

After the take effect date, Genesys allowed some organizations to continue to use the endpoint for data beyond 558 days. This allowlist exception ends March 1, 2023. 

Note: When you work with the interaction view 558 days in the past, the page loads asynchronously, and can take a longer than usual to load.

FAQs

What does this mean?

The Between the announcement date and the API TTL change, Genesys recommends that anyone working with the Analytics Conversation Detail Endpoint transitions to the Analytics Conversation Detail Async Endpoint for any historical queries. 

Am I affected?

If you or anyone in your organization accesses the Conversation Detail Endpoint API and previously requested to be allow listed from support, then you are affected. 

What do I need to do before the Change Date?

Between the announcement date and the take effect and allowlist end dates, Genesys recommends that anyone who works with with this API endpoint transitions to the Analytics Conversation Detail Async Endpoint for any historical queries. 

You can also access recordings older than 558 days in the Interactions view. For more information, see Retention period for analytics data and recording.

Who should I contact if I need help or have additional questions?

Contact deprecation@genesys.com, My Support, developer.mypurecloud.com, or developer.mypurecloud.com/forum