Skip to main content

List SLOs

GET 
/slos

Returns the list of SLOs available in your organization.

Authentication required

Authenticate API requests using an access token. Include it in the Authorization header as: Bearer TOKEN.

Retrieving all SLOs from the /slos endpoint​

The /slos endpoint supports pagination to efficiently manage large datasets. By default, this endpoint returns a maximum of 500 SLOs per page. You can use the limit query parameter to specify the number of results, up to 500 items. To fetch additional pages, use the cursor parameter. The cursor value is provided in the next link relation in the response.

Follow the instructions to get and navigate through the list of retrieved SLOs:

  1. Make an initial request to the /slos endpoint, specifying the desired number of results using the limit parameter:

    GET /slos?limit=100

  2. The response includes (1) a list of SLOs, (2) a next link in the links object if there are more results to fetch:

    "links": {"next": "/slos?limit=100&cursor=abc123"}

  3. In the next requests, use the cursor parameter from the next link to retrieve the next page of results:

    GET /slos?limit=100&cursor=abc123

  4. Continue making requests using the cursor from the next link until no next link is included in the response, indicating all results have been retrieved.

Rate limits​

All requests to the endpoint /api/v2/slos are rate-limited. An organization can make up to 10 requests per second.

The API returns 429 HTTP status code when this limit is exceeded.

Request​

Responses​

Success

Last updated on