# SuperCool API

> SuperCool is one AI agent behind one endpoint. Send it a plain-language message (POST https://api.supercool.com/v1/messages) and it plans the work, runs the tools and returns the finished result: videos, images, websites, decks, research and writing. Same agent, memory and chats as the SuperCool app, phone, WhatsApp, the CLI and the MCP.

Authenticate with `Authorization: Bearer sc_key_…` (keys: https://supercool.com/dashboard#api). Keys are server-side secrets: the API sends no CORS headers. Every page below is Markdown; the whole set is in one file at https://supercool.com/docs/llms-full.txt.

## Get started

- [The SuperCool API](https://supercool.com/docs/api/index.md): One agent, one endpoint. Send SuperCool a plain-language message and get back finished work, like videos, images, sites, decks and research.
- [Quickstart](https://supercool.com/docs/api/quickstart.md): Get an API key, send your SuperCool agent a message, wait for the work to finish and download the files, with curl, Python or JavaScript.
- [Authentication](https://supercool.com/docs/api/authentication.md): Authenticate to the SuperCool API with a bearer API key. How to create, store, rotate and revoke keys, and why keys stay on your server.

## Guides

- [Sending messages](https://supercool.com/docs/api/messages.md): Send your SuperCool agent a message with POST /v1/messages. Attach files, follow up on work in progress, answer the agent's questions and route webhooks.
- [Getting results](https://supercool.com/docs/api/results.md): Follow a SuperCool message to its result. Long-poll GET /v1/messages/{id}, read events or use webhooks, and handle every status, reason and job.
- [Webhooks](https://supercool.com/docs/api/webhooks.md): Get a signed POST when SuperCool work finishes. Register endpoints, pick events, verify Standard Webhooks signatures, and handle retries.
- [Files & uploads](https://supercool.com/docs/api/files.md): Download what the SuperCool agent made with signed links, refresh expired or changed links, and send files, from small inline attachments to 500 MB uploads.
- [Work](https://supercool.com/docs/api/work.md): List and read your SuperCool agent's work. The same chats you see in the app, whether they started over the API, in the app, by phone or elsewhere.
- [Credits & pricing](https://supercool.com/docs/api/credits.md): The SuperCool API uses the same credits as the app. Talking to the agent is free; credits are used when it starts work. What happens when you run out.

## Reference

- [API reference](https://supercool.com/docs/api/reference.md): Every endpoint of the SuperCool API: parameters, request and response schemas, errors, and curl, Python and JavaScript samples.
- [Rate limits & errors](https://supercool.com/docs/api/errors.md): Every SuperCool API error code, what it means and how to fix it, plus rate limits, rate-limit headers, request ids and the request inspector.
- [Idempotency & retries](https://supercool.com/docs/api/idempotency.md): Retry SuperCool API requests safely. How the Idempotency-Key header works, how long keys and messages are kept, and which requests are safe to repeat.
- [OpenAPI spec (JSON)](https://supercool.com/docs/api/openapi.json): The machine-readable OpenAPI 3.1 description of every endpoint.
- [OpenAPI spec (YAML)](https://supercool.com/docs/api/openapi.yaml): The same spec as YAML.

## Resources

- [Use SuperCool from AI agents](https://supercool.com/docs/api/agents.md): Give coding agents and AI apps what they need to use SuperCool. llms.txt, every docs page as Markdown, the OpenAPI spec, the MCP server and the CLI.
- [Changelog](https://supercool.com/docs/api/changelog.md): New features and changes in the SuperCool API, newest first. Also available as an RSS feed.

## Optional

- [All docs in one file](https://supercool.com/docs/llms-full.txt): Every page above plus the full reference, as Markdown.
- [SuperCool MCP](https://supercool.com/mcp): Connect SuperCool to Claude, ChatGPT, Cursor and other MCP clients.
- [SuperCool CLI](https://supercool.com/cli): Your SuperCool agent in the terminal.
- [Changelog RSS](https://supercool.com/docs/api/changelog/feed.xml): API changes as a feed.