What fields can I send when creating a run?
POST https://api.agent.clatterlabs.xyz/v1/runs needs a key with runs:write.
| Field | Required | Notes |
|---|---|---|
input | Yes | What Cosmos should do, in plain language. Up to 20,000 characters. |
title | No | Up to 80 characters. Defaults to the first line of input. |
tier | No | auto (default), flash, max or heavy. |
metadata | No | Your own JSON object, up to 2 KB, returned as-is. |
The whole request body can be up to 64 KB.
Response#
201 right away with the run: its id (a UUID), status, title, tier, metadata, key_id and timestamps. output is null until the run completes.
Errors to expect#
400 bad_request:inputmissing ortiernot one of the four values.413 too_large:input,metadataor the body is over its limit.429 too_many_runs: 5 runs already in progress.402 out_of_credits: no credit left.
Learn more#
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.xyzFor deleting your whole account or the data of one service.