Skip to main content
The scaling.cloud API is a REST API at https://api.scaling.cloud/v1. Use it to manage incidents, on-call schedules, escalation policies, and team members programmatically — from CI/CD pipelines, Terraform, or any HTTP client.

Authentication

API key format, setup, and security practices.

Errors

Error shapes, types, codes, and HTTP status codes.

Incidents

Create, list, and update incident status.

On-call schedules

Manage rotation schedules and layers.

Escalation policies

Define ordered escalation steps for incidents.

Team

List and manage organization members.

​
Base URL

All API endpoints are relative to:

​
Request format

All requests and responses use JSON. Set Content-Type: application/json on every request that includes a body.

​
Authentication

Every request must include a valid API key in the Authorization header:
See Authentication for how to obtain and use API keys.

​
Example request

​
Request IDs

Every API response includes a requestId field — a UUID that uniquely identifies the request. Include this value when contacting support so the scaling.cloud team can locate the relevant logs.

​
Resource IDs

All resource IDs (incidents, schedules, layers, policies) are UUIDs. IDs never change after creation and are stable across updates — you can safely store them as long-lived references in external systems such as Terraform state.

​
Timestamps

All timestamps are ISO 8601 strings in UTC, for example: 2026-01-01T00:00:00.000Z.

​
Pagination

List endpoints use cursor-based pagination. Each response that has more results includes a nextCursor string. Pass that value as the cursor query parameter to retrieve the next page.
​
cursor
string
Opaque cursor returned by the previous response. Omit to start from the first page.
​
limit
number
default:"20"
Number of results per page. Accepted range: 1–100.
Example paginated response:
When nextCursor is absent or null, you have reached the last page. Fetching the next page:

​
Errors

All error responses follow a consistent shape with a type, a code, and the request’s requestId. See Errors for the full reference.