{"openapi":"3.0.4","info":{"title":"Kenso API: Kenso status","version":"1.1","description":"The Kenso status endpoints of the Kenso API, with every component they use. The full spec is https://api.ken.so/v1/docs/openapi.json. Every request sends `Authorization: Bearer <your API key>` and `Ken-Version: 2026-11-02`."},"servers":[{"url":"https://api.ken.so"}],"security":[{"Bearer":[]}],"tags":[{"name":"status","description":"The status of Kenso's public components: the API, sending and webhooks. Read it to tell a Kenso outage from a problem\non your side. It takes no credential.","x-displayName":"Kenso status"}],"paths":{"/v1/status":{"get":{"tags":["status"],"summary":"Get Kenso's status","description":"Returns the status of each Kenso component and the worst of them. A component is `operational`,\n`degraded` (running late), `outage` (not running) or `unknown` (Kenso could not check it).\n            \n- `api` is `operational` whenever this call answers.\n- `sending` is `operational` while a pass of the sending dispatcher succeeded in the last 3 minutes,\n  `degraded` up to 15 minutes, then `outage`. A pass that fails does not count, so passes that keep\n  failing make it `degraded` after 3 minutes.\n- `webhooks` is `operational` while a webhook dispatch run delivered, or had nothing to deliver, in the\n  last 5 minutes, `degraded` up to 15 minutes, then `outage`. A run counts as delivered once the webhook\n  provider accepted its events; a run that could not hand them over does not count.\n            \nThe status says whether each pipeline is running, not how one workspace's sends or webhook deliveries went: a\nwebhook endpoint that answers with an error does not make `webhooks` degraded, because the provider accepts\nthe event and retries that endpoint itself. Kenso runs the check at most\nevery 30 seconds and marks the response cacheable for 30 seconds.\n            \nNeeds no credential, and answers the same without a `Ken-Version` header, so\n`curl https://api.ken.so/v1/status` works as is.\n\nRate limit: 120 calls a minute per IP address.","operationId":"status.get","parameters":[{"name":"Ken-Version","in":"header","description":"The API version, a date in `YYYY-MM-DD` form. `1.1` is another name for the first dated version. The default shown here is the newest version, which this reference's samples and Test Request send. Leave it out to use your API key's pinned version. Keys created in the Kenso app are pinned to the newest version; keys minted by the CLI login are not. A key with no pinned version and no header gets the legacy shape where the path has one, and `404` where the path exists only in this version. A date that is not a version answers `400 unsupported_version`; any other value that is not a version is treated as legacy.","schema":{"enum":["2026-11-02","1.1"],"type":"string","default":"2026-11-02"},"examples":{"default":{"value":"2026-11-02","x-disabled":false}}}],"responses":{"200":{"description":"OK","headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}},"content":{"text/plain":{"schema":{"$ref":"#/components/schemas/PlatformStatusResponse"}},"application/json":{"schema":{"$ref":"#/components/schemas/PlatformStatusResponse"}},"text/json":{"schema":{"$ref":"#/components/schemas/PlatformStatusResponse"}}}}},"security":[],"x-ken-permission":{"kind":"anonymous","summary":"None: no API key needed"},"x-ken-rate-limit":{"limit":120,"windowSeconds":60,"per":"ip"}}}},"components":{"securitySchemes":{"Bearer":{"type":"http","description":"Enter: Bearer {your Kenso API key}. Create one in the Kenso app under Settings > Integrations > API Keys.","scheme":"bearer","bearerFormat":"Opaque API key"}},"headers":{"RateLimit-Limit":{"description":"The request limit of the rate limit this request is closest to reaching: your plan's limit for this kind of call, your API key's own limit, or the operation's own limit, whichever has the fewest requests left.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"The requests left under that limit. `0` on a `429`.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"The seconds until that limit resets.","schema":{"type":"integer"}}},"schemas":{"PlatformStatus":{"type":"object","properties":{"status":{"allOf":[{"$ref":"#/components/schemas/PlatformStatusLevel"}],"description":"The worst status of the components: `outage`, then `degraded`, then `unknown`, then `operational`."},"checkedAt":{"type":"string","description":"When Kenso ran this check, in UTC. Kenso runs it at most every 30 seconds.","format":"date-time"},"components":{"type":"array","items":{"$ref":"#/components/schemas/PlatformStatusComponent"},"description":"The components, in a fixed order: `api`, `sending`, `webhooks`.","nullable":true}},"additionalProperties":false,"description":"The status of Kenso's public components (`GET /v1/status`). It reports whether each pipeline is running, never\nhow one workspace's sends or webhooks went."},"PlatformStatusComponent":{"type":"object","properties":{"id":{"type":"string","description":"The component's stable id: `api`, `sending` or `webhooks`. New ids may be added.","nullable":true},"name":{"type":"string","description":"The component's display name, such as `Sending`.","nullable":true},"status":{"allOf":[{"$ref":"#/components/schemas/PlatformStatusLevel"}],"description":"How the component is doing."},"lastActivityAt":{"type":"string","description":"When the component last showed it was running, in UTC: for `sending` the start of the newest dispatch pass\nthat succeeded, for `webhooks` the start of the newest webhook dispatch run that delivered or had nothing to\ndeliver, for `api` the check itself. Omitted when Kenso found no such run in the last hour or could not check.","format":"date-time","nullable":true}},"additionalProperties":false,"description":"One Kenso component and how it is doing."},"PlatformStatusLevel":{"enum":["operational","degraded","outage","unknown"],"type":"string","description":"How a Kenso component is doing."},"PlatformStatusResponse":{"type":"object","properties":{"success":{"type":"boolean","description":"Always true on a success."},"data":{"allOf":[{"$ref":"#/components/schemas/PlatformStatus"}],"description":"The result of the operation."}},"additionalProperties":false,"description":"The body of a successful operation that returns one result. The result is in `data`."}}}}