What happens right after I create a run?

1. The API checks your key, Account ID, permissions, credits and the 5-runs-in-progress limit.
2. It answers 201 right away with the run object. status is usually already running; output is null.
3. Cosmos starts work on your account's cloud computer: it plans, writes and runs code, uses tools and saves files.
4. You follow along with GET /v1/runs/{id}/events (recommended) or poll GET /v1/runs/{id} every 2 seconds or more.
5. The run ends as completed, failed or cancelled.

You don't need to keep a connection open: runs keep going if you disconnect.

Learn more#

• Your first real run
• Create a run