logo
logo

Throttling

Our backend services apply throttling to ensure consistent performance across all services. When the backend is receiving too many requests from one specific user/client it will return responses with status code 429 (Too Many Requests). These responses will not contain the requested payload.

Retrying

Warning

Make sure to handle the case where the Retry-After header is missing to prevent instantly retrying until the backend releases the client again. This would increase the load on the server instead of reducing it.

A Retry-After header might be included in the response. This header will contains the amount of seconds the client is supposed to wait. Sending requests before this threshold is reached, will all results in responses with status code 429. There is no benefit in not respecting the Retry-After value.

When the Retry-After value header is missing, a default value can be chosen freely, for example 30 seconds.

Note

When you receive an HTTP 429 response from Content Hub, the sleep period is always one second. This value is returned in the header of the response, and you cannot change it.

Limits

To ensure system stability, a rate limit of 15 calls (requests) per second, per API Integration User is enforced. Exceeding this rate will result in "429 too many requests" error responses.

Throttling is not applied to users using the Portal with a web browser.

Versions with throttling support

Throttling support was added in version 3.2.0, but was also backported to version 3.0.5 and 3.1.2.

See also

Can we improve this article ? Provide feedback