Overview
API reference
The Clatter Labs Agent API runs Cosmos Agent, with its tools and cloud computer, from any language over HTTPS.
Base URL
Text
https://api.agent.clatterlabs.xyzAll requests use HTTPS. Request and response bodies are JSON, except the event stream (text/event-stream).
Authentication
Send your API key and your Account ID on every request. See Authentication.
HTTP
Authorization: Bearer clsk_...
X-Clatter-Account: CL-XXXXXXXXEndpoints
| Method | Path | Permission | |
|---|---|---|---|
GET | /agent-config | none | Describe the API |
POST | /v1/runs | runs:write | Create a run |
GET | /v1/runs | runs:read | List runs |
GET | /v1/runs/{id} | runs:read | Get a run |
GET | /v1/runs/{id}/events | runs:read | Stream run events |
POST | /v1/runs/{id}/cancel | runs:write | Cancel a run |
GET | /v1/account | account:read | Get account |
Versioning
The API version is a date, returned by /agent-config as version (currently 2026-10-27). Changes that could break your code get a new version and a changelog entry.
Try it
Every endpoint page has a Try it button. It sends real requests from your browser straight to the API; your key stays in that browser tab and never passes through this site.
Was this page helpful?