Cosmos Agent API
Agent runs, tiers, streamed events, cancelling, scopes and cloud computer metering.
Top articles
- What is the Cosmos Agent API?
- Can I use the Agent API on the Free plan?
- What event types does the run event stream send?
- What fields can I send when creating a run?
- Can I call the Agent API from a browser or mobile app?
- How do I start my first Agent API run?
- Someone left our company. What should we do about Agent API keys?
- Can my company use the Agent API?
- Can Cosmos use my other tools and services during a run?
- How do I move from the Cosmos Agent app to the Agent API?
Topics
Getting startedWhat the Cosmos Agent API is, who it is for and how to start your first run.API keys and authenticationCreating keys, permissions, the X-Clatter-Account header and keeping keys safe.Creating runsWriting instructions, titles and metadata, and what happens after you start a run.Tiers: auto, Flash, Max and HeavyChoosing a SuperCosmos tier for each run and how tiers are billed.Streaming eventsFollowing runs live with server-sent events, reconnecting and reading steps.Results, listing and cancellingReading outputs and files, listing and fetching runs, and cancelling them.Cloud computer, browser and storageThe cloud computer each run works on, its tools, and how computer time, actions, browser and storage are metered.Billing and creditsHow Agent API runs are paid for, free credit, top-ups and running out.Rate limits and run limitsRequests per minute, runs in progress, input sizes and steps per run.Errors and troubleshootingEvery Agent API error code, what it means and what to do.Safety and the abuse policyWarnings, suspensions, end-user text and using the agent responsibly.Teams and companiesUsing the Agent API in a company: teams, keys per service, budgets and reviews.Retired Cosmos Agent appThe Cosmos Agent desktop and web app were retired. What changed and how to move to the API.
Still need help?
Can’t find your Cosmos Agent API answer? Email us. We usually reply within the first hour, and always within 24 hours. A full support team is with you.
Infrastructure questions, or permanent deletion of your data
infrastructure@clatterlabs.xyzFor deleting your whole account or the data of one service.