Reducing maximum page size for queue member GET endpoint

Category: API

Summary: We will reduce the maximum page size for the GET /routing/queues/{queueId}/users endpoint from 500 to 100. This is to improve system resilience, due to the load that a request with a large page size combined with certain parameters can have on the system.

Impact: Callers may see fewer items per response page than previously. All data is still available, but may be spread across more pages.

Date of Change: On or after April 15, 2019

Impacted APIs:

  • GET /routing/queues/{queueId}/users

After the release, if a request comes with page size = 500, does it return an error, or does it simply return 100 results only?

1 Like

Thanks for the heads up. I would ask the same:

the endpoint will just return up to 100 items. it will not throw an error if the requested page size is over 100. (we want this change to be largely non-breaking.)

1 Like

To add to this, this is the existing behavior for this API today but it enforces a cap of 500 if you request something larger. The change is only to lower that cap; the behavior of the API remains unchanged. You'll only be impacted by this if you have something hardcoded to access more than 100 elements from the response instead of counting the items in the result set. If you're dynamically processing the results based on the length of the collection, you shouldn't have to make any changes, even if you're still requesting 500 items per page.

1 Like

Thank you for the confirmation!

This topic was automatically closed 62 days after the last reply. New replies are no longer allowed.