Clatter LabsHelp Center

How do I use the "Run your first agent task" card on Home?

How-toUpdated

The card gives you everything for a first Cosmos Agent run.

  1. Select Create API key. Keep the default Agent API preset (runs:write, runs:read) and copy the key.
  2. Open the Create a run tab. The code already includes your Account ID. Put your key into CLATTER_API_KEY and run it. The API answers 201 straight away with the run's id.
  3. Open Stream events to follow the run live: you'll see a status event, steps as Cosmos works, and a final done event.
  4. Open Get the result to fetch the run's output and saved files.

Runs are paid from your credits on every plan, at the model rates plus small charges for computer time and actions. A short test run costs very little.

Want to try without code first? Use the Playground › Agent tab.

Full guide: Quickstart.

Learn more#

Still need help?#

We usually reply within the first hour, and always within 24 hours. A full support team is with you.

Related articles

Still need help?

Tried the steps above and still stuck? 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.xyz
For deleting your whole account or the data of one service.