- Deletes and downtime alerts are real.
uptime.delete,ssl.delete,pagespeed.delete,heartbeat.delete,maintenanceWindows.deleteandcontactGroups.deleteremove the resource immediately and cannot be undone; deleting a maintenance window resumes alerts at once. - Updates are partial. PUT endpoints change only the fields you pass. The API reads an empty field as “clear it”:
uptime.updatewithtags: []removes every tag, while omittingtagsleaves them alone. - Arrays in checks.
tags,contact_groups,dns_ipsandregionsare sent as repeatedfield[]parameters, the format StatusCake documents. - Two paging styles. Resource lists (
uptime.list,ssl.listand the rest) takepageandlimitand answermetadata.page_countandtotal_count. Record lists (uptime.history,uptime.periods,uptime.alerts,pagespeed.history) takelimit,beforeandafterUnix seconds, answer newest first, and put the continuation point inlinks.next, which is absent on the last page. - Rate limits. Free accounts may make 60 requests per minute and every account has a burst limit of 5 per second. Responses carry
x-ratelimit-limit,x-ratelimit-remainingandx-ratelimit-reset(seconds until the window lifts); the plugin retries a 429 up to three times, waiting the reset time. The quota is shared by every client using the account’s tokens. - Bad tokens. A wrong or deleted token is denied before the request reaches the API, so the error carries no body; the plugin reports it as an authentication failure.
- No webhook receiver. StatusCake sends alert callbacks to a contact group’s
ping_url, whichcontactGroups.createandcontactGroups.updatecan set. The plugin does not receive those deliveries.
- 36 typed API operations
Setup
1
Install
2
Add the plugin
corsair.ts
multiTenancy: true, scope calls with corsair.withTenant(id). See Quick start for KEK + Hub keys, and Multi-tenancy for account isolation.3
Choose authentication
- API Key (Recommended)
Store the StatusCake API key before the first call: More: API Key
pnpm corsair setup --plugin=statuscake --tenant=acme api_key=<your-key> (leave out --tenant without multiTenancy), or pass it as key in the plugin options. With Hub, each tenant enters their own key on the connect page. See API key auth.4
Connect a tenant
Mint a connect link and send the tenant to it. Hub hosts the page and delivers the result to your app — see Connect / OAuth.
Example API calls
List down checks tagged productionWhat’s next
API reference
Every
statuscake.api.* operation with input and output types.Connect / OAuth
createLink, Hub delivery, and tenant connect flows.
Use with agents
Expose this plugin’s operations as MCP tools.