Skip to main content

Nobl9 SLO Status API 1.0 (1.0.0)

WARNING
This API (v1) is deprecated and will be sunset on Fri, 30 Jan 2026 12:00:00 GMT.
Please migrate to the SLO Status API v2 as soon as possible.
Migration from SLO Status API v1 to v2

When migrating from SLO Status API v1 to v2, note the following key changes:

  1. Endpoint paths:
    • v1: /api/v1/slos and /api/v1/slos/{sloName}
    • v2: /api/v2/slos and /api/v2/slos/{sloName}
  2. Field structure updates:
    In v2, the project and service fields are now returned as objects, not strings.
    v1 example:
     
        "project": "sample-project"
        
    v2 example:
     
        "project": {
          "name": "sample-project",
          "displayName": "Sample project",
          "labels": { "team": ["platform"] }
        }
        
  3. Schema validation:
    Update any integration code or parsing logic to handle the nested object structure for project and service fields.
  4. Authentication and rate limits:
    Remain unchanged in v2.

Review your integrations for field structure dependencies and test requests against the v2 endpoints before the v1 sunset date.

Access Token

Generate access token

To generate access token, you must provide Authorization header with the Basic scheme.

The access token consists of your Client ID and Client Secret in the following format: clientId:clientSecret.

Rate Limits for access token

All requests to the endpoint /api/accessToken are rate limited. An organization can make 1 request per 3 seconds.

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

NOTE
Your token will be valid for 1 hour. Minimize the usage of this endpoint and reuse the token until it expires.

We recommend downloading your token once and reusing it in your CI/CD pipeline. Generating multiple tokens may exceed your rate limits.

Authorizations:
basicAuth
header Parameters
Organization
required
string

ID of your organization.

Responses

Request samples

curl -X \
POST https://app.nobl9.com/api/accessToken -H 'Accept: application/json; version=v1alpha' \
-H 'Organization: your-organization-id' \
-H 'Authorization: Basic ${encoded_access_keys}'

Response samples

Content type
application/json
{
  • "access_token": "string"
}

SLO

List SLOs

Return a SLO list for a specific organization

Authorizations:
bearerAuth
query Parameters
limit
integer

Specifies the number of returned results (maximum of 500 items).

cursor
string

Specifies the pagination cursor for the next page of results. You can get it through the next link property.

header Parameters
Organization
required
string

ID of your organization.

Responses

Response samples

Content type
application/json
{
  • "data": [
    ],
  • "links": {
    }
}

Find SLO by name

Returns a single SLO

Authorizations:
bearerAuth
path Parameters
sloName
required
string <= 63 characters

Name of the SLO to return.

query Parameters
fields
string
Example: fields=counts

Use to request for additional metrics, such as aggregated good and total counts.
Currently supported counts, which returns the total and good counts for each of the SLO's objective.
To specify the range of data to be gathered, use to and from query parameters (e.g., from=2021-01-01T00:00:00Z&to=2021-01-02T00:00:00Z).

from
string <date-time>
Example: from=2024-01-25T23:00:00Z

Specifies the start date and time for the data range (in UTC). Required when using the fields and to parameter.
The API allows to retrieve 7 days of data.

to
string <date-time>
Example: to=2024-01-25T23:59:00Z

Specifies the end date and time for the data range (in UTC). Required when using the fields and from parameter.
The API allows to retrieve 7 days of data.

header Parameters
Organization
required
string

ID of your organization.

project
required
string

Filters results by a specific project.

Responses

Response samples

Content type
application/json
{
  • "name": "sample-latency-slo",
  • "displayName": "Sample latency SLO",
  • "description": "This is a sample latency SLO",
  • "project": "sample-project",
  • "service": "sample-service",
  • "objectives": [
    ],
  • "createdAt": "2019-08-24T14:15:22Z",
  • "composite": {
    },
  • "labels": {
    },
  • "annotations": {
    },
  • "budgetingMethod": "Occurrences"
}