API

get/meThe key in use

Says what the key may do and which pages it reaches. Through an OAuth access token, `key` stands for the grant and `oauth` says who it acts for.

curl https://statoss.com/api/v1/me \
  -H "Authorization: Bearer sk_..."

200: The key.

{
  "key": {
    "id": "1a2b3c4d-6666-4d5e-8f7a-9b8c7d6e5f4a",
    "name": "CI",
    "access": "write",
    "pageId": "9b1d4f2a-1111-4e3c-9a8b-7c6d5e4f3a2b",
    "createdAt": "2026-09-15T08:00:00.000Z"
  }
}

Errors: 401 No key, or a key that is not valid.; 429 More than 120 requests in a minute on this key. Retry-After says in how many seconds the minute is up.; 500 Something went wrong on our side.

get/pagesList pages

Every page the key reaches, oldest first.

curl https://statoss.com/api/v1/pages \
  -H "Authorization: Bearer sk_..."

200: The pages.

Errors: 401 No key, or a key that is not valid.; 429 More than 120 requests in a minute on this key. Retry-After says in how many seconds the minute is up.; 500 Something went wrong on our side.

post/pagesMake a page

Makes a status page, and its first monitor when url is given. Needs a key for every page; a key held to one page gets a 403. The plan's page count applies.

Body

curl -X POST https://statoss.com/api/v1/pages \
  -H "Authorization: Bearer sk_..." \
  -H "Content-Type: application/json" \
  -d '{"name":"Northwind","slug":"northwind","url":"https://api.northwind.example/health"}'

201: The page, and its monitor. (PageCreated)

{
  "page": {
    "id": "9b1d4f2a-1111-4e3c-9a8b-7c6d5e4f3a2b",
    "name": "Northwind",
    "slug": "northwind",
    "url": "https://northwind.statoss.com",
    "customDomain": null,
    "description": null,
    "supportUrl": null,
    "timezone": "UTC",
    "uptimeTarget": null,
    "passwordProtected": false,
    "private": false,
    "showDeploys": false,
    "showLocations": true,
    "latencyLocations": null,
    "uptimeRegions": null,
    "accent": null,
    "theme": "auto",
    "noindex": false,
    "range": "24h",
    "poweredBy": true,
    "foldGroups": false,
    "vendorsCount": true,
    "logoUrl": null,
    "faviconUrl": null,
    "createdAt": "2026-10-12T08:00:00.000Z"
  },
  "monitor": null
}

Errors: 400 The body did not pass validation.; 401 No key, or a key that is not valid.; 403 A read-only key on a write route, or a key that may not do this.; 409 It cannot be done as things stand.; 422 The plan does not include this, or its limit is reached.; 429 More than 120 requests in a minute on this key. Retry-After says in how many seconds the minute is up.; 500 Something went wrong on our side.

get/pages/{pageId}One page

curl https://statoss.com/api/v1/pages/PAGE_ID \
  -H "Authorization: Bearer sk_..."

200: The page.

Errors: 401 No key, or a key that is not valid.; 404 Nothing by that id that this key reaches.; 429 More than 120 requests in a minute on this key. Retry-After says in how many seconds the minute is up.; 500 Something went wrong on our side.

patch/pages/{pageId}Change a page

Name, address, description, support link, uptime target, time zone, which regions count, and how the page looks: accent, theme, search engines, the opening range, the footer. Send only what changes. The logo, the domain and who can open the page have routes of their own; the plan is not changed here.

Body

curl -X PATCH https://statoss.com/api/v1/pages/PAGE_ID \
  -H "Authorization: Bearer sk_..." \
  -H "Content-Type: application/json" \
  -d '{"description":"Current status of the Northwind API, dashboard and website.","uptimeTarget":99.9}'

200: The page after the change.

Errors: 400 The body did not pass validation.; 401 No key, or a key that is not valid.; 403 A read-only key on a write route, or a key whose maker cannot open the team now: a key works while the person who made it can open the team.; 404 Nothing by that id that this key reaches.; 409 The new address is taken.; 422 The plan's limit is reached.; 429 More than 120 requests in a minute on this key. Retry-After says in how many seconds the minute is up.; 500 Something went wrong on our side.

delete/pages/{pageId}Delete a page

Deletes the page with its monitors, history, incidents and subscribers, and frees its address. Only a key made by the team's owner or an admin can. Send confirm as the page's address, in the query or the body; without it the answer is 200 with what would go and nothing is deleted.

curl -X DELETE https://statoss.com/api/v1/pages/PAGE_ID \
  -H "Authorization: Bearer sk_..."

200: Without confirm: what would go. (PageRemoval)

Errors: 400 The body did not pass validation.; 401 No key, or a key that is not valid.; 403 A read-only key on a write route, or a key that may not do this.; 404 Nothing by that id that this key reaches.; 429 More than 120 requests in a minute on this key. Retry-After says in how many seconds the minute is up.; 500 Something went wrong on our side.

get/pages/{pageId}/statusCurrent status

The same document the page serves at /status.json, whatever its password: the headline state, every monitor with its state and 24-hour figures, open incidents, and maintenance in progress or planned within the next week. Times inside incidents and maintenance are epoch milliseconds, as on the public feed; the Incident resource elsewhere uses ISO 8601.

curl https://statoss.com/api/v1/pages/PAGE_ID/status \
  -H "Authorization: Bearer sk_..."

200: The status.

Errors: 401 No key, or a key that is not valid.; 404 Nothing by that id that this key reaches.; 429 More than 120 requests in a minute on this key. Retry-After says in how many seconds the minute is up.; 500 Something went wrong on our side.

put/pages/{pageId}/logoSet the logo

Shown above the headline and at the top of update emails. PNG, JPEG, WebP, GIF, SVG or ICO, up to 512 KB. Send the file as the body.

curl -X PUT https://statoss.com/api/v1/pages/PAGE_ID/logo \
  -H "Authorization: Bearer sk_..." \
  -H "Content-Type: image/png" \
  --data-binary @image

200: The stored image.

{
  "asset": {
    "kind": "logo",
    "url": "https://northwind.statoss.com/logo?v=1760256000000",
    "contentType": "image/png",
    "bytes": 8123,
    "updatedAt": "2026-10-12T08:00:00.000Z"
  }
}

Errors: 400 The body did not pass validation.; 401 No key, or a key that is not valid.; 403 A read-only key on a write route, or a key that may not do this.; 404 Nothing by that id that this key reaches.; 429 More than 120 requests in a minute on this key. Retry-After says in how many seconds the minute is up.; 500 Something went wrong on our side.

delete/pages/{pageId}/logoRemove the logo

curl -X DELETE https://statoss.com/api/v1/pages/PAGE_ID/logo \
  -H "Authorization: Bearer sk_..."

204: Removed, or there was none.

Errors: 401 No key, or a key that is not valid.; 403 A read-only key on a write route, or a key that may not do this.; 404 Nothing by that id that this key reaches.; 429 More than 120 requests in a minute on this key. Retry-After says in how many seconds the minute is up.; 500 Something went wrong on our side.

put/pages/{pageId}/faviconSet the favicon

The icon in the visitor's browser tab. Without one, the logo is used. PNG, JPEG, WebP, GIF, SVG or ICO, up to 512 KB. Send the file as the body.

curl -X PUT https://statoss.com/api/v1/pages/PAGE_ID/favicon \
  -H "Authorization: Bearer sk_..." \
  -H "Content-Type: image/png" \
  --data-binary @image

200: The stored image.

{
  "asset": {
    "kind": "favicon",
    "url": "https://northwind.statoss.com/favicon?v=1760256000000",
    "contentType": "image/png",
    "bytes": 8123,
    "updatedAt": "2026-10-12T08:00:00.000Z"
  }
}

Errors: 400 The body did not pass validation.; 401 No key, or a key that is not valid.; 403 A read-only key on a write route, or a key that may not do this.; 404 Nothing by that id that this key reaches.; 429 More than 120 requests in a minute on this key. Retry-After says in how many seconds the minute is up.; 500 Something went wrong on our side.

delete/pages/{pageId}/faviconRemove the favicon

curl -X DELETE https://statoss.com/api/v1/pages/PAGE_ID/favicon \
  -H "Authorization: Bearer sk_..."

204: Removed, or there was none.

Errors: 401 No key, or a key that is not valid.; 403 A read-only key on a write route, or a key that may not do this.; 404 Nothing by that id that this key reaches.; 429 More than 120 requests in a minute on this key. Retry-After says in how many seconds the minute is up.; 500 Something went wrong on our side.

put/pages/{pageId}/domainSet the page's own domain

Serves the page at a hostname of its own. Pro. The hostname is checked at once; the answer says where it stands, which DNS records to add at the domain's provider (the CNAME or addresses, and a TXT record that shows the domain is the page's) and which of them it did not find. A hostname on another page that is not served there is taken from it when this page's TXT record is in DNS, never because DNS points here: the 409 names the record to add.

Body

curl -X PUT https://statoss.com/api/v1/pages/PAGE_ID/domain \
  -H "Authorization: Bearer sk_..." \
  -H "Content-Type: application/json" \
  -d '{"domain":"status.example.com"}'

200: Where the domain stands.

{
  "domain": {
    "domain": "status.example.com",
    "verified": false,
    "status": "waiting",
    "live": false,
    "problem": null,
    "message": "status.example.com saved. DNS does not point here yet.",
    "registerFailed": false,
    "served": true,
    "owned": false,
    "missing": [
      "dns",
      "txt"
    ],
    "records": [
      {
        "type": "CNAME",
        "name": "status",
        "value": "edge.statoss.com"
      },
      {
        "type": "TXT",
        "name": "_statoss.status",
        "value": "statoss-verify=0123456789abcdef0123456789abcdef"
      }
    ],
    "dnsProvider": "Cloudflare"
  }
}

Errors: 400 The body did not pass validation.; 401 No key, or a key that is not valid.; 403 A read-only key on a write route, or a key that may not do this.; 404 Nothing by that id that this key reaches.; 409 It cannot be done as things stand.; 422 The plan does not include this, or its limit is reached.; 429 More than 120 requests in a minute on this key. Retry-After says in how many seconds the minute is up.; 500 Something went wrong on our side.

delete/pages/{pageId}/domainRemove the page's own domain

Takes the hostname off the page, which keeps its address under statoss.com. Another page may use the hostname after.

curl -X DELETE https://statoss.com/api/v1/pages/PAGE_ID/domain \
  -H "Authorization: Bearer sk_..."

204: Removed, or there was none.

Errors: 401 No key, or a key that is not valid.; 403 A read-only key on a write route, or a key that may not do this.; 404 Nothing by that id that this key reaches.; 429 More than 120 requests in a minute on this key. Retry-After says in how many seconds the minute is up.; 500 Something went wrong on our side.

post/pages/{pageId}/domain/checkCheck the page's own domain

Looks again at DNS: the TXT record that shows the domain is the page's and the CNAME or addresses, and then at the edge, the hostname and its certificate. Nothing is registered at the edge until the TXT record is seen. Call it after adding the records until status is live; missing names the ones not found.

curl -X POST https://statoss.com/api/v1/pages/PAGE_ID/domain/check \
  -H "Authorization: Bearer sk_..."

200: Where the domain stands.

{
  "domain": {
    "domain": "status.example.com",
    "verified": true,
    "status": "live",
    "live": true,
    "problem": null,
    "message": "status.example.com is live.",
    "registerFailed": false,
    "served": true,
    "owned": false,
    "missing": [
      "dns",
      "txt"
    ],
    "records": [
      {
        "type": "CNAME",
        "name": "status",
        "value": "edge.statoss.com"
      },
      {
        "type": "TXT",
        "name": "_statoss.status",
        "value": "statoss-verify=0123456789abcdef0123456789abcdef"
      }
    ],
    "dnsProvider": "Cloudflare"
  }
}

Errors: 401 No key, or a key that is not valid.; 403 A read-only key on a write route, or a key that may not do this.; 404 Nothing by that id that this key reaches.; 409 It cannot be done as things stand.; 429 More than 120 requests in a minute on this key. Retry-After says in how many seconds the minute is up.; 500 Something went wrong on our side.; 503 The edge would not register the hostname yet. Check again in a moment.

get/pages/{pageId}/accessWho can open the page

Public, behind a shared password, or private to the people and email domains allowed. A password or its hash is never shown. The list of people (viewers) is in the answer to a write key only.

curl https://statoss.com/api/v1/pages/PAGE_ID/access \
  -H "Authorization: Bearer sk_..."

200: Who can open it.

Errors: 401 No key, or a key that is not valid.; 404 Nothing by that id that this key reaches.; 429 More than 120 requests in a minute on this key. Retry-After says in how many seconds the minute is up.; 500 Something went wrong on our side.

patch/pages/{pageId}/accessChange who can open the page

Send only what changes. A private page is Pro, and so is a password; a page is never both. Each person added to a private page is mailed a link. Networks are Enterprise.

Body

curl -X PATCH https://statoss.com/api/v1/pages/PAGE_ID/access \
  -H "Authorization: Bearer sk_..." \
  -H "Content-Type: application/json" \
  -d '{"private":true,"viewerDomains":["northwind.example"],"addViewers":["[email protected]"]}'

200: Who can open it now.

Errors: 400 The body did not pass validation.; 401 No key, or a key that is not valid.; 403 A read-only key on a write route, or a key that may not do this.; 404 Nothing by that id that this key reaches.; 422 The plan does not include this, or its limit is reached.; 429 More than 120 requests in a minute on this key. Retry-After says in how many seconds the minute is up.; 500 Something went wrong on our side.

get/pages/{pageId}/monitorsList monitors

curl https://statoss.com/api/v1/pages/PAGE_ID/monitors \
  -H "Authorization: Bearer sk_..."

200: The monitors in page order.

{
  "monitors": [
    {
      "id": "0f7c2d3e-4a5b-4c6d-8e9f-0a1b2c3d4e5f",
      "pageId": "9b1d4f2a-1111-4e3c-9a8b-7c6d5e4f3a2b",
      "name": "API",
      "type": "http",
      "target": "https://api.example.com/health",
      "url": "https://api.example.com/health",
      "host": null,
      "port": null,
      "dnsType": null,
      "dnsExpect": null,
      "warnDays": null,
      "expiresAt": null,
      "heartbeat": null,
      "group": "Backend",
      "method": "GET",
      "expectStatus": null,
      "keyword": "ok",
      "keywordMode": "present",
      "slowThresholdMs": 800,
      "position": 0,
      "status": "up",
      "since": "2026-09-13T20:11:00.000Z",
      "lastCheck": {
        "at": "2026-09-15T09:41:03.000Z",
        "ok": true,
        "statusCode": 200,
        "latencyMs": 142,
        "error": null
      },
      "uptime24h": 100,
      "latencyMs24h": 151,
      "createdAt": "2026-09-01T08:00:00.000Z"
    }
  ]
}

Errors: 401 No key, or a key that is not valid.; 404 Nothing by that id that this key reaches.; 429 More than 120 requests in a minute on this key. Retry-After says in how many seconds the minute is up.; 500 Something went wrong on our side.

post/pages/{pageId}/monitorsAdd a monitor

The fields that count depend on type; the rest are ignored. The plan's monitor count applies, except to components. The first check runs within a minute.

Body

curl -X POST https://statoss.com/api/v1/pages/PAGE_ID/monitors \
  -H "Authorization: Bearer sk_..." \
  -H "Content-Type: application/json" \
  -d '{"name":"API","type":"http","url":"https://api.example.com/health","groupName":"Backend","keyword":"ok","slowThresholdMs":800}'

201: The new monitor.

{
  "monitor": {
    "id": "0f7c2d3e-4a5b-4c6d-8e9f-0a1b2c3d4e5f",
    "pageId": "9b1d4f2a-1111-4e3c-9a8b-7c6d5e4f3a2b",
    "name": "API",
    "type": "http",
    "target": "https://api.example.com/health",
    "url": "https://api.example.com/health",
    "host": null,
    "port": null,
    "dnsType": null,
    "dnsExpect": null,
    "warnDays": null,
    "expiresAt": null,
    "heartbeat": null,
    "group": "Backend",
    "method": "GET",
    "expectStatus": null,
    "keyword": "ok",
    "keywordMode": "present",
    "slowThresholdMs": 800,
    "position": 0,
    "status": "unknown",
    "since": null,
    "lastCheck": null,
    "uptime24h": null,
    "latencyMs24h": null,
    "createdAt": "2026-09-01T08:00:00.000Z"
  }
}

Errors: 400 The body did not pass validation.; 401 No key, or a key that is not valid.; 403 A read-only key on a write route, or a key whose maker cannot open the team now: a key works while the person who made it can open the team.; 404 Nothing by that id that this key reaches.; 422 The plan's limit is reached.; 429 More than 120 requests in a minute on this key. Retry-After says in how many seconds the minute is up.; 500 Something went wrong on our side.

get/pages/{pageId}/monitors/{monitorId}One monitor

curl https://statoss.com/api/v1/pages/PAGE_ID/monitors/MONITOR_ID \
  -H "Authorization: Bearer sk_..."

200: The monitor.

{
  "monitor": {
    "id": "0f7c2d3e-4a5b-4c6d-8e9f-0a1b2c3d4e5f",
    "pageId": "9b1d4f2a-1111-4e3c-9a8b-7c6d5e4f3a2b",
    "name": "API",
    "type": "http",
    "target": "https://api.example.com/health",
    "url": "https://api.example.com/health",
    "host": null,
    "port": null,
    "dnsType": null,
    "dnsExpect": null,
    "warnDays": null,
    "expiresAt": null,
    "heartbeat": null,
    "group": "Backend",
    "method": "GET",
    "expectStatus": null,
    "keyword": "ok",
    "keywordMode": "present",
    "slowThresholdMs": 800,
    "position": 0,
    "status": "up",
    "since": "2026-09-13T20:11:00.000Z",
    "lastCheck": {
      "at": "2026-09-15T09:41:03.000Z",
      "ok": true,
      "statusCode": 200,
      "latencyMs": 142,
      "error": null
    },
    "uptime24h": 100,
    "latencyMs24h": 151,
    "createdAt": "2026-09-01T08:00:00.000Z"
  }
}

Errors: 401 No key, or a key that is not valid.; 404 Nothing by that id that this key reaches.; 429 More than 120 requests in a minute on this key. Retry-After says in how many seconds the minute is up.; 500 Something went wrong on our side.

patch/pages/{pageId}/monitors/{monitorId}Change a monitor

Send only what changes; a field left out keeps its value and null clears it. The type cannot change; make a new monitor instead.

Body

curl -X PATCH https://statoss.com/api/v1/pages/PAGE_ID/monitors/MONITOR_ID \
  -H "Authorization: Bearer sk_..." \
  -H "Content-Type: application/json" \
  -d '{"slowThresholdMs":500}'

200: The monitor after the change.

Errors: 400 The body did not pass validation.; 401 No key, or a key that is not valid.; 403 A read-only key on a write route, or a key whose maker cannot open the team now: a key works while the person who made it can open the team.; 404 Nothing by that id that this key reaches.; 429 More than 120 requests in a minute on this key. Retry-After says in how many seconds the minute is up.; 500 Something went wrong on our side.

delete/pages/{pageId}/monitors/{monitorId}Remove a monitor

Removes the monitor and its history. No undo.

curl -X DELETE https://statoss.com/api/v1/pages/PAGE_ID/monitors/MONITOR_ID \
  -H "Authorization: Bearer sk_..."

204: Removed.

Errors: 401 No key, or a key that is not valid.; 403 A read-only key on a write route, or a key whose maker cannot open the team now: a key works while the person who made it can open the team.; 404 Nothing by that id that this key reaches.; 429 More than 120 requests in a minute on this key. Retry-After says in how many seconds the minute is up.; 500 Something went wrong on our side.

post/pages/{pageId}/monitors/{monitorId}/checkCheck a monitor now

Runs one check and records it, as the dashboard's Check now does. Twelve a minute for the account; past that, a 429. A monitor the plan has paused is not checked.

curl -X POST https://statoss.com/api/v1/pages/PAGE_ID/monitors/MONITOR_ID/check \
  -H "Authorization: Bearer sk_..."

200: The monitor and what the check found. (MonitorCheck)

Errors: 401 No key, or a key that is not valid.; 403 A read-only key on a write route, or a key that may not do this.; 404 Nothing by that id that this key reaches.; 409 It cannot be done as things stand.; 429 More than 120 requests in a minute on this key. Retry-After says in how many seconds the minute is up.; 500 Something went wrong on our side.

get/pages/{pageId}/incidentsList incidents

Newest first, with every update. Pass open=true for only what is still open.

curl https://statoss.com/api/v1/pages/PAGE_ID/incidents \
  -H "Authorization: Bearer sk_..."

200: The incidents.

{
  "incidents": [
    {
      "id": "3c9e8f7a-2222-4b1c-8d7e-6f5a4b3c2d1e",
      "kind": "incident",
      "title": "Elevated API error rate",
      "status": "identified",
      "impact": "partial",
      "startedAt": "2026-09-15T09:02:00.000Z",
      "endsAt": null,
      "resolvedAt": null,
      "automatic": false,
      "postmortem": null,
      "monitors": [
        {
          "id": "0f7c2d3e-4a5b-4c6d-8e9f-0a1b2c3d4e5f",
          "name": "API"
        }
      ],
      "updates": [
        {
          "id": "7a6b5c4d-3333-4e2f-9a8b-1c2d3e4f5a6b",
          "status": "identified",
          "body": "A bad deploy. Rolling back.",
          "createdAt": "2026-09-15T09:20:00.000Z"
        },
        {
          "id": "8b7c6d5e-4444-4f3a-8b9c-2d3e4f5a6b7c",
          "status": "investigating",
          "body": "We are seeing elevated error rates on the API and are looking into it.",
          "createdAt": "2026-09-15T09:02:00.000Z"
        }
      ]
    }
  ]
}

Errors: 401 No key, or a key that is not valid.; 404 Nothing by that id that this key reaches.; 429 More than 120 requests in a minute on this key. Retry-After says in how many seconds the minute is up.; 500 Something went wrong on our side.

post/pages/{pageId}/incidentsOpen an incident or plan maintenance

Opens an incident, or with kind maintenance plans a window. Subscribers are told, the same as from the dashboard. An incident with an impact sets the page's headline while it is open.

Body

curl -X POST https://statoss.com/api/v1/pages/PAGE_ID/incidents \
  -H "Authorization: Bearer sk_..." \
  -H "Content-Type: application/json" \
  -d '{"title":"Elevated API error rate","status":"investigating","impact":"partial","message":"We are seeing elevated error rates on the API and are looking into it.","monitorIds":["0f7c2d3e-4a5b-4c6d-8e9f-0a1b2c3d4e5f"]}'

201: The incident.

{
  "incident": {
    "id": "3c9e8f7a-2222-4b1c-8d7e-6f5a4b3c2d1e",
    "kind": "incident",
    "title": "Elevated API error rate",
    "status": "identified",
    "impact": "partial",
    "startedAt": "2026-09-15T09:02:00.000Z",
    "endsAt": null,
    "resolvedAt": null,
    "automatic": false,
    "postmortem": null,
    "monitors": [
      {
        "id": "0f7c2d3e-4a5b-4c6d-8e9f-0a1b2c3d4e5f",
        "name": "API"
      }
    ],
    "updates": [
      {
        "id": "7a6b5c4d-3333-4e2f-9a8b-1c2d3e4f5a6b",
        "status": "identified",
        "body": "A bad deploy. Rolling back.",
        "createdAt": "2026-09-15T09:20:00.000Z"
      },
      {
        "id": "8b7c6d5e-4444-4f3a-8b9c-2d3e4f5a6b7c",
        "status": "investigating",
        "body": "We are seeing elevated error rates on the API and are looking into it.",
        "createdAt": "2026-09-15T09:02:00.000Z"
      }
    ]
  }
}

Errors: 400 The body did not pass validation.; 401 No key, or a key that is not valid.; 403 A read-only key on a write route, or a key whose maker cannot open the team now: a key works while the person who made it can open the team.; 404 Nothing by that id that this key reaches.; 429 More than 120 requests in a minute on this key. Retry-After says in how many seconds the minute is up.; 500 Something went wrong on our side.

get/pages/{pageId}/incidents/{incidentId}One incident

curl https://statoss.com/api/v1/pages/PAGE_ID/incidents/INCIDENT_ID \
  -H "Authorization: Bearer sk_..."

200: The incident.

{
  "incident": {
    "id": "3c9e8f7a-2222-4b1c-8d7e-6f5a4b3c2d1e",
    "kind": "incident",
    "title": "Elevated API error rate",
    "status": "identified",
    "impact": "partial",
    "startedAt": "2026-09-15T09:02:00.000Z",
    "endsAt": null,
    "resolvedAt": null,
    "automatic": false,
    "postmortem": null,
    "monitors": [
      {
        "id": "0f7c2d3e-4a5b-4c6d-8e9f-0a1b2c3d4e5f",
        "name": "API"
      }
    ],
    "updates": [
      {
        "id": "7a6b5c4d-3333-4e2f-9a8b-1c2d3e4f5a6b",
        "status": "identified",
        "body": "A bad deploy. Rolling back.",
        "createdAt": "2026-09-15T09:20:00.000Z"
      },
      {
        "id": "8b7c6d5e-4444-4f3a-8b9c-2d3e4f5a6b7c",
        "status": "investigating",
        "body": "We are seeing elevated error rates on the API and are looking into it.",
        "createdAt": "2026-09-15T09:02:00.000Z"
      }
    ]
  }
}

Errors: 401 No key, or a key that is not valid.; 404 Nothing by that id that this key reaches.; 429 More than 120 requests in a minute on this key. Retry-After says in how many seconds the minute is up.; 500 Something went wrong on our side.

patch/pages/{pageId}/incidents/{incidentId}Edit an incident

Title, impact, the window, the monitors, the post-mortem. Nothing is posted or mailed; that is what updates are for.

Body

curl -X PATCH https://statoss.com/api/v1/pages/PAGE_ID/incidents/INCIDENT_ID \
  -H "Authorization: Bearer sk_..." \
  -H "Content-Type: application/json" \
  -d '{"impact":"major"}'

200: The incident after the change.

Errors: 400 The body did not pass validation.; 401 No key, or a key that is not valid.; 403 A read-only key on a write route, or a key whose maker cannot open the team now: a key works while the person who made it can open the team.; 404 Nothing by that id that this key reaches.; 429 More than 120 requests in a minute on this key. Retry-After says in how many seconds the minute is up.; 500 Something went wrong on our side.

delete/pages/{pageId}/incidents/{incidentId}Delete an incident

Removes it and its updates from the page. No undo.

curl -X DELETE https://statoss.com/api/v1/pages/PAGE_ID/incidents/INCIDENT_ID \
  -H "Authorization: Bearer sk_..."

204: Deleted.

Errors: 401 No key, or a key that is not valid.; 403 A read-only key on a write route, or a key whose maker cannot open the team now: a key works while the person who made it can open the team.; 404 Nothing by that id that this key reaches.; 429 More than 120 requests in a minute on this key. Retry-After says in how many seconds the minute is up.; 500 Something went wrong on our side.

post/pages/{pageId}/incidents/{incidentId}/updatesPost an update

Adds an update and tells subscribers. On an incident, status resolved closes it. On a maintenance window, status completed ends it now. An update on an automatic incident makes it manual: it no longer resolves itself.

Body

curl -X POST https://statoss.com/api/v1/pages/PAGE_ID/incidents/INCIDENT_ID/updates \
  -H "Authorization: Bearer sk_..." \
  -H "Content-Type: application/json" \
  -d '{"status":"resolved","message":"Rolled back. Error rates are normal again."}'

201: The incident with the new update.

Errors: 400 The body did not pass validation.; 401 No key, or a key that is not valid.; 403 A read-only key on a write route, or a key whose maker cannot open the team now: a key works while the person who made it can open the team.; 404 Nothing by that id that this key reaches.; 429 More than 120 requests in a minute on this key. Retry-After says in how many seconds the minute is up.; 500 Something went wrong on our side.

get/pages/{pageId}/deploysList deploys

The last 50 markers, newest first.

curl https://statoss.com/api/v1/pages/PAGE_ID/deploys \
  -H "Authorization: Bearer sk_..."

200: The deploys.

{
  "deploys": [
    {
      "id": "5d4c3b2a-5555-4a9b-8c7d-6e5f4a3b2c1d",
      "pageId": "9b1d4f2a-1111-4e3c-9a8b-7c6d5e4f3a2b",
      "version": "v2.14.0",
      "url": "https://github.com/example/api/releases/tag/v2.14.0",
      "note": null,
      "monitorIds": null,
      "at": "2026-09-15T08:58:00.000Z",
      "createdAt": "2026-09-15T08:58:04.000Z"
    }
  ]
}

Errors: 401 No key, or a key that is not valid.; 404 Nothing by that id that this key reaches.; 429 More than 120 requests in a minute on this key. Retry-After says in how many seconds the minute is up.; 500 Something went wrong on our side.

post/pages/{pageId}/deploysMark a deploy

Draws a marker on the response-time chart in the dashboard and, when the page shows deploys, on the public page. Post it from CI after a release.

Body

curl -X POST https://statoss.com/api/v1/pages/PAGE_ID/deploys \
  -H "Authorization: Bearer sk_..." \
  -H "Content-Type: application/json" \
  -d '{"version":"v2.14.0","url":"https://github.com/example/api/releases/tag/v2.14.0"}'

201: The marker.

{
  "deploy": {
    "id": "5d4c3b2a-5555-4a9b-8c7d-6e5f4a3b2c1d",
    "pageId": "9b1d4f2a-1111-4e3c-9a8b-7c6d5e4f3a2b",
    "version": "v2.14.0",
    "url": "https://github.com/example/api/releases/tag/v2.14.0",
    "note": null,
    "monitorIds": null,
    "at": "2026-09-15T08:58:00.000Z",
    "createdAt": "2026-09-15T08:58:04.000Z"
  }
}

Errors: 400 The body did not pass validation.; 401 No key, or a key that is not valid.; 403 A read-only key on a write route, or a key whose maker cannot open the team now: a key works while the person who made it can open the team.; 404 Nothing by that id that this key reaches.; 429 More than 120 requests in a minute on this key. Retry-After says in how many seconds the minute is up.; 500 Something went wrong on our side.

delete/pages/{pageId}/deploys/{deployId}Remove a deploy marker

curl -X DELETE https://statoss.com/api/v1/pages/PAGE_ID/deploys/DEPLOY_ID \
  -H "Authorization: Bearer sk_..."

204: Removed.

Errors: 401 No key, or a key that is not valid.; 403 A read-only key on a write route, or a key whose maker cannot open the team now: a key works while the person who made it can open the team.; 404 Nothing by that id that this key reaches.; 429 More than 120 requests in a minute on this key. Retry-After says in how many seconds the minute is up.; 500 Something went wrong on our side.

get/alert-destinationsList alert destinations

The account's destinations, oldest first, with the pages that send to each. A key that writes also sees where each points. A key held to one page, or a token held to one app, does not reach the account's destinations.

curl https://statoss.com/api/v1/alert-destinations \
  -H "Authorization: Bearer sk_..."

200: The destinations.

{
  "destinations": [
    {
      "id": "5b0f3c1e-0000-4d2a-9f8e-7a6b5c4d3e2f",
      "kind": "email",
      "name": "[email protected]",
      "target": "[email protected]",
      "secret": null,
      "eu": false,
      "emergency": false,
      "confirmed": false,
      "available": true,
      "pageIds": [
        "7c2d9e4a-0000-4b1c-8a3f-2e1d0c9b8a77"
      ],
      "createdAt": "2026-10-12T08:00:00.000Z"
    }
  ]
}

Errors: 401 No key, or a key that is not valid.; 403 A read-only key, a key that does not reach this, or a person who is not the team's owner or an admin.; 429 More than 120 requests in a minute on this key, or too many mails or tests for now. Retry-After says in how many seconds to try again.; 500 Something went wrong on our side.

post/alert-destinationsAdd an alert destination

Adds a destination to the account, ticked on pageIds. The same one again is found, not doubled. An email address is mailed a link and gets no alerts until it is opened. Chat, pager and webhook destinations are on Hobby and Pro. At most 50 destinations, and 20 on a page.

Body

curl -X POST https://statoss.com/api/v1/alert-destinations \
  -H "Authorization: Bearer sk_..." \
  -H "Content-Type: application/json" \
  -d '{"kind":"email","target":"[email protected]","pageIds":["7c2d9e4a-0000-4b1c-8a3f-2e1d0c9b8a77"]}'

200: It was on the list already.

Errors: 400 The body or the query did not pass validation.; 401 No key, or a key that is not valid.; 403 A read-only key, a key that does not reach this, or a person who is not the team's owner or an admin.; 422 The plan or a limit does not allow it.; 429 More than 120 requests in a minute on this key, or too many mails or tests for now. Retry-After says in how many seconds to try again.; 500 Something went wrong on our side.

patch/alert-destinations/{destinationId}Change an alert destination

Points it somewhere else and sets the pages that send to it; what the body leaves out stays. An email address and a Slack channel that was connected are not changed, only their pages.

Body

curl -X PATCH https://statoss.com/api/v1/alert-destinations/DESTINATION_ID \
  -H "Authorization: Bearer sk_..." \
  -H "Content-Type: application/json" \
  -d '{"pageIds":["7c2d9e4a-0000-4b1c-8a3f-2e1d0c9b8a77"]}'

200: The destination.

{
  "destination": {
    "id": "5b0f3c1e-0000-4d2a-9f8e-7a6b5c4d3e2f",
    "kind": "email",
    "name": "[email protected]",
    "target": "[email protected]",
    "secret": null,
    "eu": false,
    "emergency": false,
    "confirmed": false,
    "available": true,
    "pageIds": [
      "7c2d9e4a-0000-4b1c-8a3f-2e1d0c9b8a77"
    ],
    "createdAt": "2026-10-12T08:00:00.000Z"
  }
}

Errors: 400 The body or the query did not pass validation.; 401 No key, or a key that is not valid.; 403 A read-only key, a key that does not reach this, or a person who is not the team's owner or an admin.; 404 Nothing by that id that this key reaches.; 422 The plan or a limit does not allow it.; 429 More than 120 requests in a minute on this key, or too many mails or tests for now. Retry-After says in how many seconds to try again.; 500 Something went wrong on our side.

delete/alert-destinations/{destinationId}Remove an alert destination

Removes it from the account and from every page that sends to it.

curl -X DELETE https://statoss.com/api/v1/alert-destinations/DESTINATION_ID \
  -H "Authorization: Bearer sk_..."

204: Removed.

Errors: 401 No key, or a key that is not valid.; 403 A read-only key, a key that does not reach this, or a person who is not the team's owner or an admin.; 404 Nothing by that id that this key reaches.; 429 More than 120 requests in a minute on this key, or too many mails or tests for now. Retry-After says in how many seconds to try again.; 500 Something went wrong on our side.

post/alert-destinations/{destinationId}/resendSend the confirmation link again

Mails an email destination the link that confirms it. One already confirmed answers confirmed: true and sends nothing. The mail limits apply: a link held back is a 429.

curl -X POST https://statoss.com/api/v1/alert-destinations/DESTINATION_ID/resend \
  -H "Authorization: Bearer sk_..."

200: Whether a link went out.

Errors: 400 The body or the query did not pass validation.; 401 No key, or a key that is not valid.; 403 A read-only key, a key that does not reach this, or a person who is not the team's owner or an admin.; 404 Nothing by that id that this key reaches.; 429 More than 120 requests in a minute on this key, or too many mails or tests for now. Retry-After says in how many seconds to try again.; 500 Something went wrong on our side.

post/alert-destinations/{destinationId}/testSend a test alert

Sends one test alert to the destination. One that refuses it answers sent: false with why. An email address that is not confirmed is a 409, and at most 5 test emails an hour go to one address.

curl -X POST https://statoss.com/api/v1/alert-destinations/DESTINATION_ID/test \
  -H "Authorization: Bearer sk_..."

200: Whether it took the alert.

{
  "sent": true,
  "error": null
}

Errors: 401 No key, or a key that is not valid.; 403 A read-only key, a key that does not reach this, or a person who is not the team's owner or an admin.; 404 Nothing by that id that this key reaches.; 409 It cannot be done as things stand.; 422 The plan or a limit does not allow it.; 429 More than 120 requests in a minute on this key, or too many mails or tests for now. Retry-After says in how many seconds to try again.; 500 Something went wrong on our side.

get/pages/{pageId}/alert-settingsA page's alert settings

Whether alerts go out, how often they repeat, the destinations and people they go to, who is paged and when subscribers hear of an outage.

curl https://statoss.com/api/v1/pages/PAGE_ID/alert-settings \
  -H "Authorization: Bearer sk_..."

200: The settings.

{
  "settings": {
    "pageId": "7c2d9e4a-0000-4b1c-8a3f-2e1d0c9b8a77",
    "alertsEnabled": true,
    "alertOwnerEmail": true,
    "repeatAlertMinutes": 30,
    "monthlyReport": false,
    "destinationIds": [
      "5b0f3c1e-0000-4d2a-9f8e-7a6b5c4d3e2f"
    ],
    "destinations": [
      {
        "id": "5b0f3c1e-0000-4d2a-9f8e-7a6b5c4d3e2f",
        "kind": "email",
        "name": "[email protected]",
        "confirmed": true,
        "available": true
      }
    ],
    "memberIds": [],
    "escalationPolicyId": null,
    "ackTimeoutMinutes": 0,
    "subscriberOutageMinutes": 5
  }
}

Errors: 401 No key, or a key that is not valid.; 404 Nothing by that id that this key reaches.; 429 More than 120 requests in a minute on this key, or too many mails or tests for now. Retry-After says in how many seconds to try again.; 500 Something went wrong on our side.

patch/pages/{pageId}/alert-settingsChange a page's alert settings

What the dashboard's Notifications tab saves; what the body leaves out stays. Everything is checked before anything is saved. The escalation policy and the acknowledgement time are for the owner's and admins' keys, with on-call. The monthly report and subscriberOutageMinutes are on Pro.

Body

curl -X PATCH https://statoss.com/api/v1/pages/PAGE_ID/alert-settings \
  -H "Authorization: Bearer sk_..." \
  -H "Content-Type: application/json" \
  -d '{"repeatAlertMinutes":30,"destinationIds":["5b0f3c1e-0000-4d2a-9f8e-7a6b5c4d3e2f"]}'

200: The settings after the change.

{
  "settings": {
    "pageId": "7c2d9e4a-0000-4b1c-8a3f-2e1d0c9b8a77",
    "alertsEnabled": true,
    "alertOwnerEmail": true,
    "repeatAlertMinutes": 30,
    "monthlyReport": false,
    "destinationIds": [
      "5b0f3c1e-0000-4d2a-9f8e-7a6b5c4d3e2f"
    ],
    "destinations": [
      {
        "id": "5b0f3c1e-0000-4d2a-9f8e-7a6b5c4d3e2f",
        "kind": "email",
        "name": "[email protected]",
        "confirmed": true,
        "available": true
      }
    ],
    "memberIds": [],
    "escalationPolicyId": null,
    "ackTimeoutMinutes": 0,
    "subscriberOutageMinutes": 5
  }
}

Errors: 400 The body or the query did not pass validation.; 401 No key, or a key that is not valid.; 403 A read-only key, a key that does not reach this, or a person who is not the team's owner or an admin.; 404 Nothing by that id that this key reaches.; 422 The plan or a limit does not allow it.; 429 More than 120 requests in a minute on this key, or too many mails or tests for now. Retry-After says in how many seconds to try again.; 500 Something went wrong on our side.

post/pages/{pageId}/alert-settings/testSend a test alert for a page

Sends one test alert to every destination the page sends to, as saved, and says which took it. A 409 when alerts are off or nothing can take them yet. Email is left out past 5 test emails an hour.

curl -X POST https://statoss.com/api/v1/pages/PAGE_ID/alert-settings/test \
  -H "Authorization: Bearer sk_..."

200: What each destination answered. (PageAlertTest)

{
  "sent": true,
  "emailSkipped": false,
  "results": [
    {
      "destinationId": "5b0f3c1e-0000-4d2a-9f8e-7a6b5c4d3e2f",
      "kind": "email",
      "name": "email to [email protected]",
      "sent": true,
      "error": null
    }
  ]
}

Errors: 401 No key, or a key that is not valid.; 403 A read-only key, a key that does not reach this, or a person who is not the team's owner or an admin.; 404 Nothing by that id that this key reaches.; 409 It cannot be done as things stand.; 429 More than 120 requests in a minute on this key, or too many mails or tests for now. Retry-After says in how many seconds to try again.; 500 Something went wrong on our side.

get/pages/{pageId}/subscribersList a page's subscribers

Newest first, a page at a time, with the counts by kind and the page's allowance. A webhook shows its host, not its URL.

curl https://statoss.com/api/v1/pages/PAGE_ID/subscribers \
  -H "Authorization: Bearer sk_..."

200: The subscribers.

{
  "subscribers": [
    {
      "id": "2e8a6c4b-0000-4f1d-b3a9-0c8e6a4b2d10",
      "pageId": "7c2d9e4a-0000-4b1c-8a3f-2e1d0c9b8a77",
      "kind": "email",
      "target": "[email protected]",
      "confirmed": false,
      "confirmedAt": null,
      "monitorIds": null,
      "secret": null,
      "createdAt": "2026-10-12T08:05:00.000Z"
    }
  ],
  "cursor": null,
  "counts": {
    "total": 1,
    "confirmed": 0,
    "unconfirmed": 1,
    "byKind": {
      "email": 1,
      "webhook": 0,
      "slack": 0,
      "discord": 0,
      "teams": 0
    }
  },
  "allowance": {
    "included": 1000,
    "blocks": 0,
    "cap": 1000,
    "overage": false,
    "confirmed": 0
  }
}

Errors: 400 The body or the query did not pass validation.; 401 No key, or a key that is not valid.; 404 Nothing by that id that this key reaches.; 429 More than 120 requests in a minute on this key, or too many mails or tests for now. Retry-After says in how many seconds to try again.; 500 Something went wrong on our side.

post/pages/{pageId}/subscribersAdd a subscriber

Subscribers are on Pro. An email address gets the confirmation mail the page's form sends and is not subscribed until its link is opened; it is never marked confirmed here. A webhook url is confirmed at once and answers with its signing secret, and a Discord or Teams webhook adds that channel. The list's allowance and the mail limits apply. Bulk import is in the dashboard.

Body

curl -X POST https://statoss.com/api/v1/pages/PAGE_ID/subscribers \
  -H "Authorization: Bearer sk_..." \
  -H "Content-Type: application/json" \
  -d '{"email":"[email protected]"}'

200: The address was on the list unconfirmed and its link was mailed again, or it was mailed too recently to send another.

Errors: 400 The body or the query did not pass validation.; 401 No key, or a key that is not valid.; 403 A read-only key, a key that does not reach this, or a person who is not the team's owner or an admin.; 404 Nothing by that id that this key reaches.; 409 It cannot be done as things stand.; 422 The plan or a limit does not allow it.; 429 More than 120 requests in a minute on this key, or too many mails or tests for now. Retry-After says in how many seconds to try again.; 500 Something went wrong on our side.

delete/pages/{pageId}/subscribers/{subscriberId}Remove a subscriber

curl -X DELETE https://statoss.com/api/v1/pages/PAGE_ID/subscribers/SUBSCRIBER_ID \
  -H "Authorization: Bearer sk_..."

204: Removed.

Errors: 401 No key, or a key that is not valid.; 403 A read-only key, a key that does not reach this, or a person who is not the team's owner or an admin.; 404 Nothing by that id that this key reaches.; 429 More than 120 requests in a minute on this key, or too many mails or tests for now. Retry-After says in how many seconds to try again.; 500 Something went wrong on our side.

get/teamThe team

The people with their roles, the invitations still open, and the seats. For the owner's and admins' keys. A key held to one page, or a token held to one app, does not reach the team.

curl https://statoss.com/api/v1/team \
  -H "Authorization: Bearer sk_..."

200: The team. (Team)

{
  "team": {
    "id": "u-4f2a",
    "name": "Acme",
    "ownerEmail": "[email protected]",
    "open": true,
    "requireTwoFactor": false,
    "seats": {
      "used": 2,
      "included": 3,
      "max": 25
    }
  },
  "members": [
    {
      "id": "m-1",
      "userId": "u-4f2a",
      "name": "Owen",
      "email": "[email protected]",
      "role": "owner",
      "twoFactor": true,
      "joinedAt": "2026-09-01T09:00:00.000Z"
    }
  ],
  "invitations": [
    {
      "id": "i-1",
      "email": "[email protected]",
      "role": "member",
      "expiresAt": "2026-10-19T08:00:00.000Z"
    }
  ]
}

Errors: 401 No key, or a key that is not valid.; 403 A read-only key, a key that does not reach this, or a person who is not the team's owner or an admin.; 429 More than 120 requests in a minute on this key, or too many mails or tests for now. Retry-After says in how many seconds to try again.; 500 Something went wrong on our side.

post/team/invitationsInvite someone

Invites by email as an admin or a member, with the dashboard's mail, open for a week. The same role again sends a reminder and answers 200; another role replaces the invitation. Teams are on Pro, 3 people included and $5 a month for each one after, up to 25; past the included seats only the owner invites. At most 20 invitations wait, and the mail limits apply.

Body

curl -X POST https://statoss.com/api/v1/team/invitations \
  -H "Authorization: Bearer sk_..." \
  -H "Content-Type: application/json" \
  -d '{"email":"[email protected]","role":"member"}'

200: A reminder for an invitation still open.

Errors: 400 The body or the query did not pass validation.; 401 No key, or a key that is not valid.; 403 A read-only key, a key that does not reach this, or a person who is not the team's owner or an admin.; 409 It cannot be done as things stand.; 422 The plan or a limit does not allow it.; 429 More than 120 requests in a minute on this key, or too many mails or tests for now. Retry-After says in how many seconds to try again.; 500 Something went wrong on our side.

delete/team/invitations/{invitationId}Cancel an invitation

Cancels one that has not been answered.

curl -X DELETE https://statoss.com/api/v1/team/invitations/INVITATION_ID \
  -H "Authorization: Bearer sk_..."

204: Cancelled.

Errors: 401 No key, or a key that is not valid.; 403 A read-only key, a key that does not reach this, or a person who is not the team's owner or an admin.; 404 Nothing by that id that this key reaches.; 429 More than 120 requests in a minute on this key, or too many mails or tests for now. Retry-After says in how many seconds to try again.; 500 Something went wrong on our side.

patch/team/members/{memberId}Change a role

Makes a member an admin or an admin a member. The owner's role never changes. An admin made a member loses the invitations they sent.

Body

curl -X PATCH https://statoss.com/api/v1/team/members/MEMBER_ID \
  -H "Authorization: Bearer sk_..." \
  -H "Content-Type: application/json" \
  -d '{"role":"admin"}'

200: The member.

Errors: 400 The body or the query did not pass validation.; 401 No key, or a key that is not valid.; 403 A read-only key, a key that does not reach this, or a person who is not the team's owner or an admin.; 404 Nothing by that id that this key reaches.; 429 More than 120 requests in a minute on this key, or too many mails or tests for now. Retry-After says in how many seconds to try again.; 500 Something went wrong on our side.

delete/team/members/{memberId}Remove a person

Removes them from the team. The API keys they made stop working and the invitations they sent are cancelled. The owner stays.

curl -X DELETE https://statoss.com/api/v1/team/members/MEMBER_ID \
  -H "Authorization: Bearer sk_..."

204: Removed.

Errors: 401 No key, or a key that is not valid.; 403 A read-only key, a key that does not reach this, or a person who is not the team's owner or an admin.; 404 Nothing by that id that this key reaches.; 429 More than 120 requests in a minute on this key, or too many mails or tests for now. Retry-After says in how many seconds to try again.; 500 Something went wrong on our side.

get/keysList API keys

Newest first, never the key itself. For the owner's and admins' keys. A key held to one page sees the keys held to its page.

curl https://statoss.com/api/v1/keys \
  -H "Authorization: Bearer sk_..."

200: The keys.

{
  "keys": [
    {
      "id": "k-9a1b",
      "name": "CI",
      "prefix": "sk_Ab3dEf",
      "access": "write",
      "pageId": "7c2d9e4a-0000-4b1c-8a3f-2e1d0c9b8a77",
      "madeBy": null,
      "createdAt": "2026-10-12T08:10:00.000Z",
      "lastUsedAt": null
    }
  ]
}

Errors: 401 No key, or a key that is not valid.; 403 A read-only key, a key that does not reach this, or a person who is not the team's owner or an admin.; 429 More than 120 requests in a minute on this key, or too many mails or tests for now. Retry-After says in how many seconds to try again.; 500 Something went wrong on our side.

post/keysMake an API key

Needs a key that writes, and the owner's or an admin's. The new key is no broader than the one making it: not more access, and from a key held to one page only for that page (a 403 otherwise). A token follows its person's role and scope, and a key made through a connected app is deleted when the app is disconnected or its access revoked (madeBy names it). At most 25 keys. The secret is in this answer once and is not stored.

Body

curl -X POST https://statoss.com/api/v1/keys \
  -H "Authorization: Bearer sk_..." \
  -H "Content-Type: application/json" \
  -d '{"name":"CI","access":"write","pageId":"7c2d9e4a-0000-4b1c-8a3f-2e1d0c9b8a77"}'

201: The key and its secret. (NewApiKey)

{
  "key": {
    "id": "k-9a1b",
    "name": "CI",
    "prefix": "sk_Ab3dEf",
    "access": "write",
    "pageId": "7c2d9e4a-0000-4b1c-8a3f-2e1d0c9b8a77",
    "madeBy": null,
    "createdAt": "2026-10-12T08:10:00.000Z",
    "lastUsedAt": null
  },
  "secret": "sk_Ab3dEf..."
}

Errors: 400 The body or the query did not pass validation.; 401 No key, or a key that is not valid.; 403 A read-only key, a key that does not reach this, or a person who is not the team's owner or an admin.; 422 The plan or a limit does not allow it.; 429 More than 120 requests in a minute on this key, or too many mails or tests for now. Retry-After says in how many seconds to try again.; 500 Something went wrong on our side.

delete/keys/{keyId}Revoke an API key

Whatever uses it stops working. A key held to one page revokes only the keys held to its page.

curl -X DELETE https://statoss.com/api/v1/keys/KEY_ID \
  -H "Authorization: Bearer sk_..."

204: Revoked.

Errors: 401 No key, or a key that is not valid.; 403 A read-only key, a key that does not reach this, or a person who is not the team's owner or an admin.; 404 Nothing by that id that this key reaches.; 429 More than 120 requests in a minute on this key, or too many mails or tests for now. Retry-After says in how many seconds to try again.; 500 Something went wrong on our side.

get/appsList apps

The apps the key reaches: all of the team's, or those on the key's page.

curl https://statoss.com/api/v1/apps \
  -H "Authorization: Bearer sk_..."

200: The apps.

{
  "apps": [
    {
      "id": "6e5d4c3b-7777-4b8a-9c0d-1e2f3a4b5c6d",
      "name": "Checkout API",
      "slug": "checkout-api",
      "num": 42,
      "platform": "node",
      "pageId": "9b1d4f2a-1111-4e3c-9a8b-7c6d5e4f3a2b",
      "createdAt": "2026-09-01T08:00:00.000Z"
    }
  ]
}

Errors: 401 No key, or a key that is not valid.; 404 Nothing by that id that this key reaches.; 429 More than 120 requests in a minute on this key. Retry-After says in how many seconds the minute is up.; 500 Something went wrong on our side.

post/appsMake an app

Makes an app with its first key. A key held to a page puts it on that page; any other key may name one of the team's pages, or none. At most 100 apps.

Body

curl -X POST https://statoss.com/api/v1/apps \
  -H "Authorization: Bearer sk_..." \
  -H "Content-Type: application/json" \
  -d '{"name":"Checkout API","platform":"node","pageId":"9b1d4f2a-1111-4e3c-9a8b-7c6d5e4f3a2b"}'

201: The app and its first key.

{
  "app": {
    "id": "6e5d4c3b-7777-4b8a-9c0d-1e2f3a4b5c6d",
    "name": "Checkout API",
    "slug": "checkout-api",
    "num": 42,
    "platform": "node",
    "pageId": "9b1d4f2a-1111-4e3c-9a8b-7c6d5e4f3a2b",
    "errorsShare": 50,
    "createdAt": "2026-09-01T08:00:00.000Z",
    "dsn": "https://[email protected]/42",
    "firstEventAt": "2026-09-01T08:12:00.000Z",
    "lastEventAt": "2026-10-08T11:58:00.000Z"
  },
  "key": {
    "key": "3f2c9a1b7d6e4f5a8b9c0d1e2f3a4b5c",
    "label": "Default",
    "dsn": "https://[email protected]/42",
    "allowedWebsites": [],
    "ratePerMinute": 1200,
    "createdAt": "2026-09-01T08:00:00.000Z",
    "revokedAt": null
  }
}

Errors: 400 The body or the query did not pass validation.; 401 No key, or a key that is not valid.; 403 A read-only key on a write route.; 404 Nothing by that id that this key reaches.; 429 More than 120 requests in a minute on this key. Retry-After says in how many seconds the minute is up.; 500 Something went wrong on our side.

get/apps/{app}One app

Its name, slug, platform, page, the DSN of its oldest live key (null for a read key), and when it first and last sent an event.

curl https://statoss.com/api/v1/apps/APP \
  -H "Authorization: Bearer sk_..."

200: The app.

{
  "app": {
    "id": "6e5d4c3b-7777-4b8a-9c0d-1e2f3a4b5c6d",
    "name": "Checkout API",
    "slug": "checkout-api",
    "num": 42,
    "platform": "node",
    "pageId": "9b1d4f2a-1111-4e3c-9a8b-7c6d5e4f3a2b",
    "errorsShare": 50,
    "createdAt": "2026-09-01T08:00:00.000Z",
    "dsn": "https://[email protected]/42",
    "firstEventAt": "2026-09-01T08:12:00.000Z",
    "lastEventAt": "2026-10-08T11:58:00.000Z"
  }
}

Errors: 401 No key, or a key that is not valid.; 404 Nothing by that id that this key reaches.; 429 More than 120 requests in a minute on this key. Retry-After says in how many seconds the minute is up.; 500 Something went wrong on our side.

patch/apps/{app}Change an app

Name, slug, platform, page or errorsShare; what the body leaves out stays. A key held to a page cannot move the app off it.

Body

curl -X PATCH https://statoss.com/api/v1/apps/APP \
  -H "Authorization: Bearer sk_..." \
  -H "Content-Type: application/json" \
  -d '{"name":"Checkout","slug":"checkout","errorsShare":25}'

200: The app.

{
  "app": {
    "id": "6e5d4c3b-7777-4b8a-9c0d-1e2f3a4b5c6d",
    "name": "Checkout API",
    "slug": "checkout-api",
    "num": 42,
    "platform": "node",
    "pageId": "9b1d4f2a-1111-4e3c-9a8b-7c6d5e4f3a2b",
    "errorsShare": 50,
    "createdAt": "2026-09-01T08:00:00.000Z",
    "dsn": "https://[email protected]/42",
    "firstEventAt": "2026-09-01T08:12:00.000Z",
    "lastEventAt": "2026-10-08T11:58:00.000Z"
  }
}

Errors: 400 The body or the query did not pass validation.; 401 No key, or a key that is not valid.; 403 A read-only key on a write route.; 404 Nothing by that id that this key reaches.; 429 More than 120 requests in a minute on this key. Retry-After says in how many seconds the minute is up.; 500 Something went wrong on our side.

delete/apps/{app}Remove an app

Removes the app with its keys, alert rules and issues; its rules' open alerts are resolved. Without confirm, answers with what would go and changes nothing.

curl -X DELETE https://statoss.com/api/v1/apps/APP \
  -H "Authorization: Bearer sk_..."

200: Without confirm: what would go.

Errors: 400 The body or the query did not pass validation.; 401 No key, or a key that is not valid.; 403 A read-only key on a write route.; 404 Nothing by that id that this key reaches.; 429 More than 120 requests in a minute on this key. Retry-After says in how many seconds the minute is up.; 500 Something went wrong on our side.

get/apps/{app}/keysList an app's keys

Its keys, newest first, the revoked ones too. A read key gets each key's label and times; the key and its DSN are null.

curl https://statoss.com/api/v1/apps/APP/keys \
  -H "Authorization: Bearer sk_..."

200: The keys.

{
  "keys": [
    {
      "key": "3f2c9a1b7d6e4f5a8b9c0d1e2f3a4b5c",
      "label": "Default",
      "dsn": "https://[email protected]/42",
      "allowedWebsites": [],
      "ratePerMinute": 1200,
      "createdAt": "2026-09-01T08:00:00.000Z",
      "revokedAt": null
    }
  ],
  "cursor": null
}

Errors: 400 The body or the query did not pass validation.; 401 No key, or a key that is not valid.; 404 Nothing by that id that this key reaches.; 429 More than 120 requests in a minute on this key. Retry-After says in how many seconds the minute is up.; 500 Something went wrong on our side.

post/apps/{app}/keysAdd a key

Up to 10 live keys per app. A key for a web page can be given its allowed websites and a lower rate at once.

Body

curl -X POST https://statoss.com/api/v1/apps/APP/keys \
  -H "Authorization: Bearer sk_..." \
  -H "Content-Type: application/json" \
  -d '{"label":"Website","allowedWebsites":["example.com","*.example.com"],"ratePerMinute":300}'

201: The key.

Errors: 400 The body or the query did not pass validation.; 401 No key, or a key that is not valid.; 403 A read-only key on a write route.; 404 Nothing by that id that this key reaches.; 429 More than 120 requests in a minute on this key. Retry-After says in how many seconds the minute is up.; 500 Something went wrong on our side.

patch/apps/{app}/keys/{key}Change a key's allowed websites or rate

Protects a key that sits in a web page, where anyone can read it: allowedWebsites lists the hosts it may be used from (intake refuses a request whose Origin or Referer names another; a request with neither is taken), ratePerMinute lowers the events a minute it may send. What the body leaves out stays. A revoked key cannot be changed.

Body

curl -X PATCH https://statoss.com/api/v1/apps/APP/keys/KEY \
  -H "Authorization: Bearer sk_..." \
  -H "Content-Type: application/json" \
  -d '{"allowedWebsites":["example.com","*.example.com"],"ratePerMinute":300}'

200: The key.

Errors: 400 The body or the query did not pass validation.; 401 No key, or a key that is not valid.; 403 A read-only key on a write route.; 404 Nothing by that id that this key reaches.; 409 The key is revoked.; 429 More than 120 requests in a minute on this key. Retry-After says in how many seconds the minute is up.; 500 Something went wrong on our side.

delete/apps/{app}/keys/{key}Revoke a key

Intake refuses events sent with it from then on. The last live key stays: add another first. Without confirm, answers with what it would do.

curl -X DELETE https://statoss.com/api/v1/apps/APP/keys/KEY \
  -H "Authorization: Bearer sk_..."

200: Without confirm: what it would do.

Errors: 400 The body or the query did not pass validation.; 401 No key, or a key that is not valid.; 403 A read-only key on a write route.; 404 Nothing by that id that this key reaches.; 409 Revoked already, or the last live key.; 429 More than 120 requests in a minute on this key. Retry-After says in how many seconds the minute is up.; 500 Something went wrong on our side.

get/apps/{app}/schemaAn app's schema

Its levels, categories, fields and rules, with the version. The five built-in levels are always there.

curl https://statoss.com/api/v1/apps/APP/schema \
  -H "Authorization: Bearer sk_..."

200: The schema. (AppSchema)

Errors: 401 No key, or a key that is not valid.; 404 Nothing by that id that this key reaches.; 429 More than 120 requests in a minute on this key. Retry-After says in how many seconds the minute is up.; 500 Something went wrong on our side.

post/apps/{app}/schema/planPlan a change

Checks up to 50 changes without making them, and answers with what each would do, any warnings and a handle that apply takes within 15 minutes, with the same key. confirm is true for a merge or a remove. Instead of changes, desired takes a whole schema as code declares it (levels, categories and fields, each with only the settings to set, and rules); the server works out the changes and answers them in changes, or no handle and the summary "No change". prune also removes kept values and rules it leaves out.

Body

curl -X POST https://statoss.com/api/v1/apps/APP/schema/plan \
  -H "Authorization: Bearer sk_..." \
  -H "Content-Type: application/json" \
  -d '{"changes":[{"op":"set","kind":"category","key":"billing","label":"Billing","color":"plum"}]}'

200: The plan. (SchemaPlan)

{
  "handle": "q3V9cXJ0eW1vZGVsc2NoZW1h",
  "expiresAt": "2026-10-08T12:15:00.000Z",
  "version": 3,
  "summary": "Changed the category billing",
  "effects": [
    {
      "what": "category billing",
      "action": "changed",
      "before": {
        "kept": false,
        "label": null,
        "color": null,
        "severity": null,
        "position": 0,
        "hidden": false,
        "mergedInto": null,
        "ownerId": null,
        "fieldType": null,
        "unit": null,
        "filterable": false
      },
      "after": {
        "kept": true,
        "label": "Billing",
        "color": "plum",
        "severity": null,
        "position": 0,
        "hidden": false,
        "mergedInto": null,
        "ownerId": null,
        "fieldType": null,
        "unit": null,
        "filterable": false
      }
    }
  ],
  "warnings": [],
  "confirm": false
}

Errors: 400 The body did not pass validation.; 401 No key, or a key that is not valid.; 403 A read-only key on a write route, or a key whose maker cannot open the team now: a key works while the person who made it can open the team.; 404 Nothing by that id that this key reaches.; 429 More than 120 requests in a minute on this key. Retry-After says in how many seconds the minute is up.; 500 Something went wrong on our side.

post/apps/{app}/schema/applyApply a plan

Makes the planned changes, if the schema has not changed since the plan. The change is recorded and can be undone.

Body

curl -X POST https://statoss.com/api/v1/apps/APP/schema/apply \
  -H "Authorization: Bearer sk_..." \
  -H "Content-Type: application/json" \
  -d '{"handle":"q3V9cXJ0eW1vZGVsc2NoZW1h"}'

200: The change, what it did, and the schema after. (SchemaApplied)

Errors: 400 The body did not pass validation.; 401 No key, or a key that is not valid.; 403 A read-only key on a write route, or a key whose maker cannot open the team now: a key works while the person who made it can open the team.; 404 Nothing by that id that this key reaches.; 409 Something changed since: plan again, or undo the later change first.; 429 More than 120 requests in a minute on this key. Retry-After says in how many seconds the minute is up.; 500 Something went wrong on our side.

get/apps/{app}/schema/changesList changes

The app's schema changes, newest first, from the dashboard, the API and the MCP.

curl https://statoss.com/api/v1/apps/APP/schema/changes \
  -H "Authorization: Bearer sk_..."

200: The changes.

Errors: 400 The body did not pass validation.; 401 No key, or a key that is not valid.; 404 Nothing by that id that this key reaches.; 429 More than 120 requests in a minute on this key. Retry-After says in how many seconds the minute is up.; 500 Something went wrong on our side.

post/apps/{app}/schema/changes/{changeId}/undoUndo a change

Puts back what the change touched, if each row and rule still reads as the change left it; otherwise a 409 says which changed since. The undo is a change of its own.

curl -X POST https://statoss.com/api/v1/apps/APP/schema/changes/CHANGE_ID/undo \
  -H "Authorization: Bearer sk_..."

200: The undo, what it did, and the schema after. (SchemaApplied)

Errors: 401 No key, or a key that is not valid.; 403 A read-only key on a write route, or a key whose maker cannot open the team now: a key works while the person who made it can open the team.; 404 Nothing by that id that this key reaches.; 409 Something changed since: plan again, or undo the later change first.; 429 More than 120 requests in a minute on this key. Retry-After says in how many seconds the minute is up.; 500 Something went wrong on our side.

get/issuesList issues

Issues of the key's apps seen in the range, as the dashboard lists them, with counts for the environment and range. q is the search language (/docs/search) as Issues reads it: words in the title and culprit, /regex/, level:, category:, priority:, assigned:, is:, age:, firstSeen:, lastSeen:, times_seen: and fields such as browser:Firefox, with -term or !key:value to leave out, a OR b, key:[a, b], * at either end of a value, key:>500 and has:key. Of the 1,000 seen latest. A search that does not read answers 400 with why.

curl https://statoss.com/api/v1/issues \
  -H "Authorization: Bearer sk_..."

200: The issues. (IssueList)

{
  "issues": [
    {
      "id": "2b7e1c4d-8888-4f1a-9b2c-3d4e5f6a7b8c",
      "shortId": "CHECKOUT-API-12",
      "app": {
        "id": "6e5d4c3b-7777-4b8a-9c0d-1e2f3a4b5c6d",
        "name": "Checkout API",
        "slug": "checkout-api"
      },
      "title": "TypeError: Cannot read properties of undefined (reading 'total')",
      "culprit": "priceCart (src/cart.ts)",
      "type": "error",
      "platform": "node",
      "level": {
        "key": "error",
        "label": "Error",
        "color": "red"
      },
      "category": {
        "key": "billing",
        "label": "Billing",
        "color": "plum"
      },
      "status": "unresolved",
      "substatus": "new",
      "priority": "high",
      "assignee": null,
      "firstSeen": "2026-10-08T09:12:44.000Z",
      "lastSeen": "2026-10-08T11:58:02.000Z",
      "firstRelease": "[email protected]",
      "lastRelease": "[email protected]",
      "timesSeen": 214,
      "counts": {
        "events": 214,
        "users": 37
      },
      "resolvedAt": null,
      "resolvedInRelease": null,
      "archivedUntil": null,
      "resolveInNextRelease": null,
      "reviewed": false,
      "url": "https://statoss.com/app/issues/2b7e1c4d-8888-4f1a-9b2c-3d4e5f6a7b8c"
    }
  ],
  "total": 1,
  "cursor": null,
  "countsError": null
}

Errors: 400 The query or body did not pass validation.; 401 No key, or a key that is not valid.; 404 Nothing by that id that this key reaches.; 429 More than 120 requests in a minute on this key. Retry-After says in how many seconds the minute is up.; 500 Something went wrong on our side.

get/issues/{issueId}An issue

The issue with counts and its tags' common values over the environment and range, its latest event in short (exception, frames with source lines, the last 20 breadcrumbs, tags) and its activity. If events cannot be read, the issue still comes back, with eventsError set.

curl https://statoss.com/api/v1/issues/{issueId} \
  -H "Authorization: Bearer sk_..."

200: The issue. (IssueDetail)

Errors: 400 The query or body did not pass validation.; 401 No key, or a key that is not valid.; 404 Nothing by that id that this key reaches.; 429 More than 120 requests in a minute on this key. Retry-After says in how many seconds the minute is up.; 500 Something went wrong on our side.

patch/issues/{issueId}Change an issue

Any of status, resolveInNextRelease, priority, assignee and reviewed, made in that order. Resolving or archiving resolves the issue's alerts, which tells whoever they went to.

Body

curl -X PATCH https://statoss.com/api/v1/issues/{issueId} \
  -H "Authorization: Bearer sk_..." \
  -H "Content-Type: application/json" \
  -d '{"status":"resolved","assignee":"[email protected]"}'

200: The issue after. (Issue)

Errors: 400 The query or body did not pass validation.; 401 No key, or a key that is not valid.; 403 A read-only key on a write route.; 404 Nothing by that id that this key reaches.; 429 More than 120 requests in a minute on this key. Retry-After says in how many seconds the minute is up.; 500 Something went wrong on our side.

get/issues/{issueId}/eventsAn issue's events

Newest first, in the environment, and within the range when one is given; every event kept otherwise.

curl https://statoss.com/api/v1/issues/{issueId}/events \
  -H "Authorization: Bearer sk_..."

200: The events. (EventList)

Errors: 400 The query or body did not pass validation.; 401 No key, or a key that is not valid.; 404 Nothing by that id that this key reaches.; 429 More than 120 requests in a minute on this key. Retry-After says in how many seconds the minute is up.; 500 Something went wrong on our side.; 503 Events could not be read just now; try again shortly.

post/issues/{issueId}/commentsComment on an issue

Adds a comment to its activity, in the name of the key's maker.

Body

curl -X POST https://statoss.com/api/v1/issues/{issueId}/comments \
  -H "Authorization: Bearer sk_..." \
  -H "Content-Type: application/json" \
  -d '{"body":"Fixed in 2.14.1, deploying now."}'

201: The comment. (IssueComment)

Errors: 400 The query or body did not pass validation.; 401 No key, or a key that is not valid.; 403 A read-only key on a write route.; 404 Nothing by that id that this key reaches.; 429 More than 120 requests in a minute on this key. Retry-After says in how many seconds the minute is up.; 500 Something went wrong on our side.

post/issues/mergeMerge issues

Merges issues of one app into the oldest: their events, hashes and activity move to it and the others are removed, with their alerts resolved. A merge cannot be undone, so without "confirm": true the answer says what it would do and nothing changes.

Body

curl -X POST https://statoss.com/api/v1/issues/merge \
  -H "Authorization: Bearer sk_..." \
  -H "Content-Type: application/json" \
  -d '{"issueIds":["CHECKOUT-API-12","CHECKOUT-API-15"],"confirm":true}'

200: What it did, or would do. (IssueMerge)

Errors: 400 The query or body did not pass validation.; 401 No key, or a key that is not valid.; 403 A read-only key on a write route.; 404 Nothing by that id that this key reaches.; 429 More than 120 requests in a minute on this key. Retry-After says in how many seconds the minute is up.; 500 Something went wrong on our side.

get/eventsSearch events

Events as Explore finds them, newest first: in the apps, environment and range, at the levels and in the categories (by key or label), with each field holding its value, and matching q. q is the search language (/docs/search) as Explore reads it: words, phrases and /regex/ in the title, culprit or message, level:, category: and fields, with -term or !key:value to leave out, a OR b, key:[a, b], * at either end of a value, key:>500 and has:key. A search that does not read answers 400 with why.

curl https://statoss.com/api/v1/events \
  -H "Authorization: Bearer sk_..."

200: The events. (EventList)

Errors: 400 The query or body did not pass validation.; 401 No key, or a key that is not valid.; 404 Nothing by that id that this key reaches.; 429 More than 120 requests in a minute on this key. Retry-After says in how many seconds the minute is up.; 500 Something went wrong on our side.; 503 Events could not be read just now; try again shortly.

get/events/{eventId}An event

The whole event as it was stored, scrubbed, with its issue: exceptions and frames with variables, breadcrumbs, request, user, contexts, tags, extra and the grouping used.

curl https://statoss.com/api/v1/events/{eventId} \
  -H "Authorization: Bearer sk_..."

200: The event. (Event)

Errors: 401 No key, or a key that is not valid.; 404 Nothing by that id that this key reaches.; 429 More than 120 requests in a minute on this key. Retry-After says in how many seconds the minute is up.; 500 Something went wrong on our side.; 503 Events could not be read just now; try again shortly.

get/releasesList releases

Releases of the key's apps, newest first by their first event, with the issues each brought, brought back and resolved.

curl https://statoss.com/api/v1/releases \
  -H "Authorization: Bearer sk_..."

200: The releases. (ReleaseList)

Errors: 400 The query or body did not pass validation.; 401 No key, or a key that is not valid.; 404 Nothing by that id that this key reaches.; 429 More than 120 requests in a minute on this key. Retry-After says in how many seconds the minute is up.; 500 Something went wrong on our side.

get/releases/{releaseId}A release

Its new, regressed and resolved issues, up to 200 each, and the deploy marker of its version on the app's page.

curl https://statoss.com/api/v1/releases/{releaseId} \
  -H "Authorization: Bearer sk_..."

200: The release. (ReleaseDetail)

Errors: 401 No key, or a key that is not valid.; 404 Nothing by that id that this key reaches.; 429 More than 120 requests in a minute on this key. Retry-After says in how many seconds the minute is up.; 500 Something went wrong on our side.

get/apps/{app}/sourcemapsList source map bundles

The bundles sentry-cli uploaded for the app, newest first, with the debug ids of their maps.

curl https://statoss.com/api/v1/apps/APP/sourcemaps \
  -H "Authorization: Bearer sk_..."

200: The bundles. (SourceMapList)

Errors: 400 The query or body did not pass validation.; 401 No key, or a key that is not valid.; 404 Nothing by that id that this key reaches.; 429 More than 120 requests in a minute on this key. Retry-After says in how many seconds the minute is up.; 500 Something went wrong on our side.

get/apps/{app}/alert-rulesList an app's alert rules

Its issue alert rules, newest first. Issue alerts are on-call alerts: without on-call (Hobby and Pro) these paths answer 404.

curl https://statoss.com/api/v1/apps/APP/alert-rules \
  -H "Authorization: Bearer sk_..."

200: The rules.

{
  "alertRules": [
    {
      "id": "2b3c4d5e-8888-4f6a-9b0c-1d2e3f4a5b6c",
      "appId": "6e5d4c3b-7777-4b8a-9c0d-1e2f3a4b5c6d",
      "name": "New and regressed issues",
      "pageId": "9b1d4f2a-1111-4e3c-9a8b-7c6d5e4f3a2b",
      "enabled": true,
      "onNew": true,
      "onRegressed": true,
      "onEscalating": false,
      "eventCount": 0,
      "eventMinutes": 60,
      "minPriority": "high",
      "minLevel": null,
      "environments": [
        "production"
      ],
      "release": null,
      "tags": [],
      "categories": [],
      "throttle": "release",
      "ownRouting": false,
      "repeatMinutes": 0,
      "groupMinutes": 0,
      "destinationIds": [],
      "memberIds": [],
      "paging": "none",
      "summary": "New issues, regressions; high priority; production; once per release",
      "createdAt": "2026-09-02T10:00:00.000Z",
      "lastFiredAt": null
    }
  ],
  "cursor": null
}

Errors: 400 The body or the query did not pass validation.; 401 No key, or a key that is not valid.; 404 Nothing by that id that this key reaches.; 429 More than 120 requests in a minute on this key. Retry-After says in how many seconds the minute is up.; 500 Something went wrong on our side.

post/apps/{app}/alert-rulesMake an alert rule

What the body leaves out takes the default rule's: new and regressed high-priority issues, once per release, to the page's destinations, paging nobody. At most 20 rules per app. Issue alerts are on-call alerts: without on-call (Hobby and Pro) these paths answer 404.

Body

curl -X POST https://statoss.com/api/v1/apps/APP/alert-rules \
  -H "Authorization: Bearer sk_..." \
  -H "Content-Type: application/json" \
  -d '{"name":"Checkout errors","onNew":true,"onRegressed":true,"minLevel":"error","environments":["production"]}'

201: The rule.

{
  "alertRule": {
    "id": "2b3c4d5e-8888-4f6a-9b0c-1d2e3f4a5b6c",
    "appId": "6e5d4c3b-7777-4b8a-9c0d-1e2f3a4b5c6d",
    "name": "New and regressed issues",
    "pageId": "9b1d4f2a-1111-4e3c-9a8b-7c6d5e4f3a2b",
    "enabled": true,
    "onNew": true,
    "onRegressed": true,
    "onEscalating": false,
    "eventCount": 0,
    "eventMinutes": 60,
    "minPriority": "high",
    "minLevel": null,
    "environments": [
      "production"
    ],
    "release": null,
    "tags": [],
    "categories": [],
    "throttle": "release",
    "ownRouting": false,
    "repeatMinutes": 0,
    "groupMinutes": 0,
    "destinationIds": [],
    "memberIds": [],
    "paging": "none",
    "summary": "New issues, regressions; high priority; production; once per release",
    "createdAt": "2026-09-02T10:00:00.000Z",
    "lastFiredAt": null
  }
}

Errors: 400 The body or the query did not pass validation.; 401 No key, or a key that is not valid.; 403 A read-only key on a write route.; 404 Nothing by that id that this key reaches.; 429 More than 120 requests in a minute on this key. Retry-After says in how many seconds the minute is up.; 500 Something went wrong on our side.

get/apps/{app}/alert-rules/{ruleId}One alert rule

Issue alerts are on-call alerts: without on-call (Hobby and Pro) these paths answer 404.

curl https://statoss.com/api/v1/apps/APP/alert-rules/RULE_ID \
  -H "Authorization: Bearer sk_..."

200: The rule.

{
  "alertRule": {
    "id": "2b3c4d5e-8888-4f6a-9b0c-1d2e3f4a5b6c",
    "appId": "6e5d4c3b-7777-4b8a-9c0d-1e2f3a4b5c6d",
    "name": "New and regressed issues",
    "pageId": "9b1d4f2a-1111-4e3c-9a8b-7c6d5e4f3a2b",
    "enabled": true,
    "onNew": true,
    "onRegressed": true,
    "onEscalating": false,
    "eventCount": 0,
    "eventMinutes": 60,
    "minPriority": "high",
    "minLevel": null,
    "environments": [
      "production"
    ],
    "release": null,
    "tags": [],
    "categories": [],
    "throttle": "release",
    "ownRouting": false,
    "repeatMinutes": 0,
    "groupMinutes": 0,
    "destinationIds": [],
    "memberIds": [],
    "paging": "none",
    "summary": "New issues, regressions; high priority; production; once per release",
    "createdAt": "2026-09-02T10:00:00.000Z",
    "lastFiredAt": null
  }
}

Errors: 401 No key, or a key that is not valid.; 404 Nothing by that id that this key reaches.; 429 More than 120 requests in a minute on this key. Retry-After says in how many seconds the minute is up.; 500 Something went wrong on our side.

patch/apps/{app}/alert-rules/{ruleId}Change an alert rule

What the body leaves out stays. Issue alerts are on-call alerts: without on-call (Hobby and Pro) these paths answer 404.

Body

curl -X PATCH https://statoss.com/api/v1/apps/APP/alert-rules/RULE_ID \
  -H "Authorization: Bearer sk_..." \
  -H "Content-Type: application/json" \
  -d '{"enabled":false}'

200: The rule after.

{
  "alertRule": {
    "id": "2b3c4d5e-8888-4f6a-9b0c-1d2e3f4a5b6c",
    "appId": "6e5d4c3b-7777-4b8a-9c0d-1e2f3a4b5c6d",
    "name": "New and regressed issues",
    "pageId": "9b1d4f2a-1111-4e3c-9a8b-7c6d5e4f3a2b",
    "enabled": true,
    "onNew": true,
    "onRegressed": true,
    "onEscalating": false,
    "eventCount": 0,
    "eventMinutes": 60,
    "minPriority": "high",
    "minLevel": null,
    "environments": [
      "production"
    ],
    "release": null,
    "tags": [],
    "categories": [],
    "throttle": "release",
    "ownRouting": false,
    "repeatMinutes": 0,
    "groupMinutes": 0,
    "destinationIds": [],
    "memberIds": [],
    "paging": "none",
    "summary": "New issues, regressions; high priority; production; once per release",
    "createdAt": "2026-09-02T10:00:00.000Z",
    "lastFiredAt": null
  }
}

Errors: 400 The body or the query did not pass validation.; 401 No key, or a key that is not valid.; 403 A read-only key on a write route.; 404 Nothing by that id that this key reaches.; 429 More than 120 requests in a minute on this key. Retry-After says in how many seconds the minute is up.; 500 Something went wrong on our side.

delete/apps/{app}/alert-rules/{ruleId}Remove an alert rule

Resolves its open alerts; their issues stay as they are. Without confirm, answers with what it would do. Issue alerts are on-call alerts: without on-call (Hobby and Pro) these paths answer 404.

curl -X DELETE https://statoss.com/api/v1/apps/APP/alert-rules/RULE_ID \
  -H "Authorization: Bearer sk_..."

200: Without confirm: what it would do.

Errors: 400 The body or the query did not pass validation.; 401 No key, or a key that is not valid.; 403 A read-only key on a write route.; 404 Nothing by that id that this key reaches.; 429 More than 120 requests in a minute on this key. Retry-After says in how many seconds the minute is up.; 500 Something went wrong on our side.

get/dashboardsList dashboards

The team's own dashboards, newest first. Each app's own dashboard is not among them: it follows the app's schema.

curl https://statoss.com/api/v1/dashboards \
  -H "Authorization: Bearer sk_..."

200: The dashboards.

Errors: 400 The body or the query did not pass validation.; 401 No key, or a key that is not valid.; 404 Nothing by that id that this key reaches.; 429 More than 120 requests in a minute on this key. Retry-After says in how many seconds the minute is up.; 500 Something went wrong on our side.

get/dashboards/{dashboardId}One dashboard

Its widgets in order. With data=1, each widget's numbers (data, or dataError when they could not be read) over the range, from the apps the key reaches. A key held to a page sees only that page's apps in queries and numbers.

curl https://statoss.com/api/v1/dashboards/DASHBOARD_ID \
  -H "Authorization: Bearer sk_..."

200: The dashboard. With data, each widget also has data (WidgetData) and dataError.

{
  "dashboard": {
    "id": "8a7b6c5d-aaaa-4e3f-9a1b-2c3d4e5f6a7b",
    "name": "Checkout",
    "createdAt": "2026-10-01T09:00:00.000Z",
    "updatedAt": "2026-10-01T09:00:00.000Z",
    "widgets": [
      {
        "id": "4d5e6f7a-9999-4b1c-8d2e-3f4a5b6c7d8e",
        "position": 0,
        "kind": "bar",
        "title": "",
        "shownTitle": "Events by level",
        "width": "full",
        "query": {
          "apps": [
            "6e5d4c3b-7777-4b8a-9c0d-1e2f3a4b5c6d"
          ],
          "measure": "events",
          "groupBy": "level",
          "field": null,
          "levels": [],
          "categories": [],
          "fields": [],
          "text": ""
        },
        "body": null,
        "createdAt": "2026-10-01T09:00:00.000Z",
        "updatedAt": "2026-10-01T09:00:00.000Z"
      }
    ]
  }
}

Errors: 400 The body or the query did not pass validation.; 401 No key, or a key that is not valid.; 404 Nothing by that id that this key reaches.; 429 More than 120 requests in a minute on this key. Retry-After says in how many seconds the minute is up.; 500 Something went wrong on our side.

post/dashboards/planPlan a change

Checks up to 50 changes to one dashboard (dashboardId), or to a new one (changes starting with create_dashboard), without making them, and answers with what each would do and a handle that apply takes within 15 minutes, with the same key. confirm is true for a removal. A key held to a page cannot change a dashboard that shows other apps.

Body

curl -X POST https://statoss.com/api/v1/dashboards/plan \
  -H "Authorization: Bearer sk_..." \
  -H "Content-Type: application/json" \
  -d '{"dashboardId":"8a7b6c5d-aaaa-4e3f-9a1b-2c3d4e5f6a7b","changes":[{"op":"add_widget","kind":"bar","width":"full","query":{"apps":["6e5d4c3b-7777-4b8a-9c0d-1e2f3a4b5c6d"],"groupBy":"level"}}]}'

200: The plan. (DashboardPlan)

{
  "handle": "d9V2cXJ0eW1vZGVsZGFzaA",
  "expiresAt": "2026-10-08T12:15:00.000Z",
  "dashboardId": "8a7b6c5d-aaaa-4e3f-9a1b-2c3d4e5f6a7b",
  "summary": "Added the widget Events by level",
  "effects": [
    {
      "what": "widget Events by level",
      "action": "added",
      "before": null,
      "after": {
        "position": 1,
        "kind": "bar",
        "width": "full"
      }
    }
  ],
  "warnings": [],
  "confirm": false
}

Errors: 400 The body or the query did not pass validation.; 401 No key, or a key that is not valid.; 403 A read-only key, or a key held to a page on a dashboard that shows other apps.; 404 Nothing by that id that this key reaches.; 429 More than 120 requests in a minute on this key. Retry-After says in how many seconds the minute is up.; 500 Something went wrong on our side.

post/dashboards/applyApply a plan

Makes the planned changes, all of them or none, if the dashboard has not changed since the plan.

Body

curl -X POST https://statoss.com/api/v1/dashboards/apply \
  -H "Authorization: Bearer sk_..." \
  -H "Content-Type: application/json" \
  -d '{"handle":"d9V2cXJ0eW1vZGVsZGFzaA"}'

200: The dashboard after (null when removed), and what changed. (DashboardApplied)

Errors: 400 The body or the query did not pass validation.; 401 No key, or a key that is not valid.; 403 A read-only key on a write route.; 404 Nothing by that id that this key reaches.; 409 Something changed since, or it cannot be done as things stand.; 429 More than 120 requests in a minute on this key. Retry-After says in how many seconds the minute is up.; 500 Something went wrong on our side.

get/viewsList saved views

The team's saved views, by area then name. A key held to a page sees only its apps in each.

curl https://statoss.com/api/v1/views \
  -H "Authorization: Bearer sk_..."

200: The views. (SavedViewList)

Errors: 400 The query or body did not pass validation.; 401 No key, or a key that is not valid.; 404 Nothing by that id that this key reaches, or the team has no logs.; 429 More than 120 requests in a minute on this key. Retry-After says in how many seconds the minute is up.; 500 Something went wrong on our side.

post/viewsSave a view

Saves a search and the filter bar under a name for the team; up to 100 in an area. A key held to a page names its apps in filters.apps.

Body

curl -X POST https://statoss.com/api/v1/views \
  -H "Authorization: Bearer sk_..." \
  -H "Content-Type: application/json" \
  -d '{"area":"logs","name":"Checkout errors","query":"service:checkout level:>=error","filters":{"apps":["checkout-api"],"environment":"production"}}'

201: The view. (SavedView)

Errors: 400 The query or body did not pass validation.; 401 No key, or a key that is not valid.; 403 A read-only key on a write route, or a token for someone who does not manage the team.; 404 Nothing by that id that this key reaches, or the team has no logs.; 429 More than 120 requests in a minute on this key. Retry-After says in how many seconds the minute is up.; 500 Something went wrong on our side.

patch/views/{viewId}Change a view

Any of name, query and filters; filters are replaced whole.

Body

curl -X PATCH https://statoss.com/api/v1/views/{viewId} \
  -H "Authorization: Bearer sk_..." \
  -H "Content-Type: application/json" \
  -d '{"name":"Checkout 5xx"}'

200: The view after. (SavedView)

Errors: 400 The query or body did not pass validation.; 401 No key, or a key that is not valid.; 403 A read-only key on a write route, or a token for someone who does not manage the team.; 404 Nothing by that id that this key reaches, or the team has no logs.; 429 More than 120 requests in a minute on this key. Retry-After says in how many seconds the minute is up.; 500 Something went wrong on our side.

delete/views/{viewId}Remove a view

Removes it for everyone on the team. Without "confirm": true in the body (or ?confirm=true) nothing changes and the answer says what it would do.

curl -X DELETE https://statoss.com/api/v1/views/{viewId} \
  -H "Authorization: Bearer sk_..."

200: What it would do, without confirm. (SavedViewRemoval)

Errors: 400 The query or body did not pass validation.; 401 No key, or a key that is not valid.; 403 A read-only key on a write route, or a token for someone who does not manage the team.; 404 Nothing by that id that this key reaches, or the team has no logs.; 429 More than 120 requests in a minute on this key. Retry-After says in how many seconds the minute is up.; 500 Something went wrong on our side.

get/logsSearch logs

Lines of the key's apps that match q in the environment and range, newest first, a page at a time.

curl https://statoss.com/api/v1/logs \
  -H "Authorization: Bearer sk_..."

200: The lines. (LogList)

{
  "logs": [
    {
      "id": "1791460800123456789-3f2a9c41d0b7e655",
      "appId": "6e5d4c3b-7777-4b8a-9c0d-1e2f3a4b5c6d",
      "appSlug": "checkout-api",
      "time": "2026-10-08T12:00:00.123456789Z",
      "severity": 17,
      "level": "error",
      "levelLabel": "Error",
      "body": "POST /pay 502 upstream timed out after 30s",
      "service": "checkout",
      "environment": "production",
      "release": "[email protected]",
      "source": "otlp",
      "traceId": "4bf92f3577b34da6a3ce929d0e0e4736",
      "spanId": "00f067aa0ba902b7",
      "attributes": {
        "http.route": "/pay",
        "http.status_code": "502"
      },
      "pattern": "8423917740921178124"
    }
  ],
  "cursor": null
}

Errors: 400 The query or body did not pass validation.; 401 No key, or a key that is not valid.; 404 Nothing by that id that this key reaches, or the team has no logs.; 422 too_broad: ClickHouse stopped the search at its limits (8 seconds and the row caps). Narrow the range or the search.; 429 More than 120 requests in a minute on this key. Retry-After says in how many seconds the minute is up.; 500 Something went wrong on our side.; 503 Logs could not be read just now; try again shortly.

get/logs/tailTail logs

Lines written after the token, in the order they were written, oldest first; without after, the newest 50 written in the last hour and a token. A line shows once it has been written for three seconds. Poll with the after each answer gives.

curl https://statoss.com/api/v1/logs/tail \
  -H "Authorization: Bearer sk_..."

200: The lines and the token. (LogTail)

Errors: 400 The query or body did not pass validation.; 401 No key, or a key that is not valid.; 404 Nothing by that id that this key reaches, or the team has no logs.; 422 too_broad: ClickHouse stopped the search at its limits (8 seconds and the row caps). Narrow the range or the search.; 429 More than 120 requests in a minute on this key. Retry-After says in how many seconds the minute is up.; 500 Something went wrong on our side.; 503 Logs could not be read just now; try again shortly.

get/logs/{logId}A log line

The line, the 25 lines before and after it from its app and service, and the issues whose events carry its trace.

curl https://statoss.com/api/v1/logs/{logId} \
  -H "Authorization: Bearer sk_..."

200: The line. (LogDetail)

Errors: 400 The query or body did not pass validation.; 401 No key, or a key that is not valid.; 404 Nothing by that id that this key reaches, or the team has no logs.; 429 More than 120 requests in a minute on this key. Retry-After says in how many seconds the minute is up.; 500 Something went wrong on our side.; 503 Logs could not be read just now; try again shortly.

get/logs/volumeLog volume

Lines per bucket by severity range, 60 to 120 buckets over the range widened to whole buckets. With no search, from the per-minute sums kept 400 days; with one, counted from the lines.

curl https://statoss.com/api/v1/logs/volume \
  -H "Authorization: Bearer sk_..."

200: The buckets. (LogVolume)

Errors: 400 The query or body did not pass validation.; 401 No key, or a key that is not valid.; 404 Nothing by that id that this key reaches, or the team has no logs.; 422 too_broad: ClickHouse stopped the search at its limits (8 seconds and the row caps). Narrow the range or the search.; 429 More than 120 requests in a minute on this key. Retry-After says in how many seconds the minute is up.; 500 Something went wrong on our side.; 503 Logs could not be read just now; try again shortly.

get/logs/facetsLog facets

Counts by level, service and environment, and the 20 commonest attribute keys with their 10 commonest values (counts approximate), over the newest minutes holding about 100,000 lines, or with a search over the whole range.

curl https://statoss.com/api/v1/logs/facets \
  -H "Authorization: Bearer sk_..."

200: The facets. (LogFacets)

Errors: 400 The query or body did not pass validation.; 401 No key, or a key that is not valid.; 404 Nothing by that id that this key reaches, or the team has no logs.; 422 too_broad: ClickHouse stopped the search at its limits (8 seconds and the row caps). Narrow the range or the search.; 429 More than 120 requests in a minute on this key. Retry-After says in how many seconds the minute is up.; 500 Something went wrong on our side.; 503 Logs could not be read just now; try again shortly.

get/logs/patternsLog patterns

The commonest patterns of the lines that match (numbers, ids, addresses and quoted strings masked as <*>), most lines first, each with its newest line, first and last seen and its level mix.

curl https://statoss.com/api/v1/logs/patterns \
  -H "Authorization: Bearer sk_..."

200: The patterns. (LogPatternList)

Errors: 400 The query or body did not pass validation.; 401 No key, or a key that is not valid.; 404 Nothing by that id that this key reaches, or the team has no logs.; 422 too_broad: ClickHouse stopped the search at its limits (8 seconds and the row caps). Narrow the range or the search.; 429 More than 120 requests in a minute on this key. Retry-After says in how many seconds the minute is up.; 500 Something went wrong on our side.; 503 Logs could not be read just now; try again shortly.

get/apps/{app}/log-alertsList an app's log alerts

Its log alert rules on pages the key reaches, newest first. Log alerts are on-call alerts: without on-call (Hobby and Pro) these paths answer 404.

curl https://statoss.com/api/v1/apps/APP/log-alerts \
  -H "Authorization: Bearer sk_..."

200: The rules.

Errors: 400 The query or body did not pass validation.; 401 No key, or a key that is not valid.; 404 Nothing by that id that this key reaches, or the team has no logs.; 429 More than 120 requests in a minute on this key. Retry-After says in how many seconds the minute is up.; 500 Something went wrong on our side.

post/apps/{app}/log-alertsMake a log alert

What the body leaves out takes the default rule's: at least 10 lines in 5 minutes, firing at once and resolving after 5 quiet minutes, to the page's destinations, paging nobody. At most 20 rules per app. Log alerts are on-call alerts: without on-call (Hobby and Pro) these paths answer 404.

Body

curl -X POST https://statoss.com/api/v1/apps/APP/log-alerts \
  -H "Authorization: Bearer sk_..." \
  -H "Content-Type: application/json" \
  -d '{"name":"Checkout 5xx","query":"service:checkout http.status_code:>=500","threshold":20,"windowMinutes":5,"environments":["production"]}'

201: The rule.

Errors: 400 The query or body did not pass validation.; 401 No key, or a key that is not valid.; 403 A read-only key on a write route, or a token for someone who does not manage the team.; 404 Nothing by that id that this key reaches, or the team has no logs.; 429 More than 120 requests in a minute on this key. Retry-After says in how many seconds the minute is up.; 500 Something went wrong on our side.

get/apps/{app}/log-alerts/{ruleId}One log alert

Log alerts are on-call alerts: without on-call (Hobby and Pro) these paths answer 404.

curl https://statoss.com/api/v1/apps/APP/log-alerts/RULE_ID \
  -H "Authorization: Bearer sk_..."

200: The rule.

Errors: 401 No key, or a key that is not valid.; 404 Nothing by that id that this key reaches, or the team has no logs.; 429 More than 120 requests in a minute on this key. Retry-After says in how many seconds the minute is up.; 500 Something went wrong on our side.

patch/apps/{app}/log-alerts/{ruleId}Change a log alert

What the body leaves out stays. Its condition starts over; turning it off resolves its alert. Log alerts are on-call alerts: without on-call (Hobby and Pro) these paths answer 404.

Body

curl -X PATCH https://statoss.com/api/v1/apps/APP/log-alerts/RULE_ID \
  -H "Authorization: Bearer sk_..." \
  -H "Content-Type: application/json" \
  -d '{"enabled":false}'

200: The rule after.

Errors: 400 The query or body did not pass validation.; 401 No key, or a key that is not valid.; 403 A read-only key on a write route, or a token for someone who does not manage the team.; 404 Nothing by that id that this key reaches, or the team has no logs.; 429 More than 120 requests in a minute on this key. Retry-After says in how many seconds the minute is up.; 500 Something went wrong on our side.

delete/apps/{app}/log-alerts/{ruleId}Remove a log alert

Resolves its open alert. Without confirm, answers with what it would do. Log alerts are on-call alerts: without on-call (Hobby and Pro) these paths answer 404.

curl -X DELETE https://statoss.com/api/v1/apps/APP/log-alerts/RULE_ID \
  -H "Authorization: Bearer sk_..."

200: Without confirm: what it would do.

Errors: 400 The query or body did not pass validation.; 401 No key, or a key that is not valid.; 403 A read-only key on a write route, or a token for someone who does not manage the team.; 404 Nothing by that id that this key reaches, or the team has no logs.; 429 More than 120 requests in a minute on this key. Retry-After says in how many seconds the minute is up.; 500 Something went wrong on our side.

get/pages/{pageId}/alertsList a page's alerts

Its open alerts, triggered before acknowledged, or with status=resolved the last 100 resolved. Alerts that joined another's group are shown under it. Without on-call, a 404.

curl https://statoss.com/api/v1/pages/PAGE_ID/alerts \
  -H "Authorization: Bearer sk_..."

200: The alerts.

{
  "alerts": [
    {
      "id": "9d1c2b3a-0000-4b8a-9c0d-1e2f3a4b5c6d",
      "pageId": "6e5d4c3b-1111-4b8a-9c0d-1e2f3a4b5c6d",
      "number": 12,
      "status": "triggered",
      "severity": "critical",
      "summary": "Checkout is down",
      "affected": "checkout-api",
      "from": "Checkout API",
      "count": 1,
      "createdAt": "2026-10-08T09:30:00.000Z",
      "acknowledgedAt": null,
      "acknowledgedBy": null,
      "resolvedAt": null,
      "resolvedBy": null,
      "acknowledgedUntil": null,
      "snoozed": false,
      "heldByMaintenance": false,
      "groupedInto": null,
      "grouped": 0,
      "url": "https://statoss.com/app/6e5d4c3b-1111-4b8a-9c0d-1e2f3a4b5c6d/alerts/9d1c2b3a-0000-4b8a-9c0d-1e2f3a4b5c6d"
    }
  ]
}

Errors: 400 The body or the query did not pass validation.; 401 No key, or a key that is not valid.; 404 Nothing by that id that this key reaches.; 429 More than 120 requests in a minute on this key. Retry-After says in how many seconds the minute is up.; 500 Something went wrong on our side.

get/pages/{pageId}/alerts/{alertId}One alert

The alert with what its sender said and its timeline. Without on-call, a 404.

curl https://statoss.com/api/v1/pages/PAGE_ID/alerts/ALERT_ID \
  -H "Authorization: Bearer sk_..."

200: The alert.

Errors: 401 No key, or a key that is not valid.; 404 Nothing by that id that this key reaches.; 429 More than 120 requests in a minute on this key. Retry-After says in how many seconds the minute is up.; 500 Something went wrong on our side.

post/pages/{pageId}/alerts/{alertId}/{action}Acknowledge, unacknowledge, resolve or snooze an alert

Needs a write key. snooze needs minutes, a whole number from 1 to 10080: nobody is paged or reminded until they run out, when the alert is triggered again if still open. A 409 when the alert is past that already. Without on-call, a 404.

Body

curl -X POST https://statoss.com/api/v1/pages/PAGE_ID/alerts/ALERT_ID/{action} \
  -H "Authorization: Bearer sk_..." \
  -H "Content-Type: application/json" \
  -d '{"note":"Looking into it."}'

200: The alert after.

Errors: 400 The body or the query did not pass validation.; 401 No key, or a key that is not valid.; 403 A read-only key on a write route.; 404 Nothing by that id that this key reaches.; 409 Something changed since, or it cannot be done as things stand.; 429 More than 120 requests in a minute on this key. Retry-After says in how many seconds the minute is up.; 500 Something went wrong on our side.

get/pages/{pageId}/on-callWho is on call

Each of the team's schedules with whoever is on call now and until when, and each policy that pages for the page (its own, and those its sources page through), level by level, with who it would page now. Schedules and policies are on Pro; elsewhere both lists are empty. Without on-call, a 404.

curl https://statoss.com/api/v1/pages/PAGE_ID/on-call \
  -H "Authorization: Bearer sk_..."

200: Who is on call. (OnCall)

Errors: 401 No key, or a key that is not valid.; 404 Nothing by that id that this key reaches.; 429 More than 120 requests in a minute on this key. Retry-After says in how many seconds the minute is up.; 500 Something went wrong on our side.