If you haven't seen it already, you can take a look at our Getting started with Gearset API guide, and our full API reference provides full details of the endpoints that Gearset exposes.

Usage Limits

Use of the Gearset API is subject to a fair usage policy. There are limits on how frequently API endpoints can be used. These limits are subject to change. Currently, they are:

5 requests per hour per action per job to:

  • Initiate an action with the automation API (e.g. starting/cancelling a continuous integration job run). These are the POST Requests for the automation API.

  • Query the reporting API (e.g. getting lead time for changes).

5 requests per 5 seconds per action per job to:

  • Query the status of something with the automation API (e.g. getting the status of a continuous integration job). These are the GET requests for the automation API

Each endpoint will return headers indicating how close your team is to the limit for that endpoint:

Header

Description

X-Rate-Limit-Limit

The period over which requests are limited (e.g. 5s for getting job status). Returned when your team has not exceeded the limit.

X-Rate-Limit-Remaining

How many more requests you are permitted to make within X-Rate-Limit-Limit. Returned when your team has not exceeded the limit.

X-Rate-Limit-Reset

The date/time (UTC, in ISO-8601 format) when the limit will reset for this endpoint. Returned when your team has not exceeded the limit.

Retry-After

You should retry after this number of seconds. Returned when your team has exceeded the limit for this endpoint.

Did this answer your question?