What do the run statuses queued, running, completed, failed and cancelled mean?

ReferenceUpdated November 2, 2026

Every run has a status. Three of them are final.

Status	Meaning	Final?
`queued`	Accepted and waiting to start	No
`running`	Cosmos is working	No
`completed`	Finished; `output` holds the answer	Yes
`failed`	Couldn't finish; `error` says why	Yes
`cancelled`	Stopped with `POST /v1/runs/{id}/cancel`	Yes

How a run moves#

queued ─▶ running ─▶ completed
                 ├─▶ failed      (error.code: run_failed | out_of_credits)
                 └─▶ cancelled

When you create a run, the API answers right away with the run, usually already running.

Not final yet: keep reading the event stream, or poll GET /v1/runs/{id} no faster than every 2 seconds.
completed: read output and files.
failed: check error.code. out_of_credits means your balance ran out midway; run_failed covers everything else.
cancelled: any files saved before the cancel are still listed.

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.

General support

Infrastructure questions, or permanent deletion of your data

For deleting your whole account or the data of one service.