Skip to content

Rate limiting

HTTP requests to the UbiOps API are rate limited. Rate limiting is a technique to control the number of incoming requests in a given time period to our API service. We do this to prevent abuse of our platforms and avoid overloads caused by excessive usage or mistakes.

In practice this means that each individual IP address can make a limited number of requests to the UbiOps API every minute.

Rate limits can be increased upon request.

Applicable rate limits

UbiOps API endpoints are grouped in four categories:

  • A request endpoint group: this includes all API endpoints for creating, listing, obtaining or deleting deployment or pipeline requests.
  • A blobs endpoint group: this includes all API endpoints for creating, listing, obtaining or deleting blobs.
  • A user endpoint group: this includes all API endpoints for registration, authentication and interacting with accounts.
  • A general endpoint group: this includes all remaining API endpoints.

The following rate limits are in place for each of the endpoint groups:

Endpoint group Maximum requests per minute
Requests endpoint group 300 per minute
Blobs endpoint group 300 per minute
User endpoint group 30 per minute
General endpoint group 150 per minute

The limits apply per endpoint group. This means that you could for example make 300 calls to endpoints in the requests endpoint group and 150 calls to endpoints in the general endpoint group in the same minute.

Headers

Every API response includes headers with information about the status of the applicable rate limits. You can use these headers to automatically keep the request rates within limits in your application.

The following headers are available:

Header Description
x-ratelimit-limit Total limit on number of requests per minute to this endpoint group
x-ratelimit-remaining Remaining limit on number of requests until the end of the current minute
x-ratelimit-reset Number of seconds until the rate limit resets

Increasing the limits

If you are hitting our limits and can not optimize your application further to make less requests, you can contact our support department to request an increase of your rate limit.

In your request, please explain your use case and usage patterns, desired limits and the IP address(es) that you want to increase the limits for.