SuperCoolDocs Get an API key

Resources

Changelog

New features and changes in the SuperCool API, newest first. Also available as an RSS feed.

View as Markdown

Changes to the SuperCool API, newest first. Follow along with the RSS feed.

Within /v1, changes are additive: new endpoints, new fields, new event types, new reason values. Build your integration to ignore fields and values it doesn't know. Anything that would break an existing integration gets a new version.

#2026-10-07 — Cancel a message, and isolated keys

  • Cancel: POST /v1/messages/{id}/cancel stops the work a message started: queued work is removed before it runs, its own running work is stopped, and work started after the cancel is cancelled as it arrives. See Cancel a message.
  • Isolated keys: for apps that serve many people with one account. Each message stands alone (no shared history, memory or other work), and the key reaches only its own messages. See Isolated keys.
  • New error code: 403 isolated_key.

#2026-09-30 — The SuperCool API is live

Your SuperCool agent is now available over HTTPS at https://api.supercool.com/v1.

  • Messages: POST /v1/messages sends your agent a message, with inline files or large uploads. Follow it with GET /v1/messages/{id}?wait=, its events, or webhooks. Each message reports its jobs, files and credits used.
  • Webhooks: signed with Standard Webhooks, with retries for up to 3 days and per-message routing.
  • Uploads: files up to 500 MB through presigned uploads.
  • Work and files: read any chat, including ones started in the app, and get fresh download links.
  • Keys and dashboard: nicknamed sc_key_ API keys with optional expiry, usage per key, and a request inspector with every request from the last 30 days.
  • Docs: these pages, llms.txt, every page as Markdown, and the OpenAPI spec.

Last updated