Sign in
runs

Create an agent run

Creates a new agent run

post/v1/runs

Headers

Authorizationstring required

Bearer authentication

Request body

typestring required

The agent type to use for this agent run

business_idstring uuid

Business to use as context for the run. Shorthand for context_type=business. Required when thread_id is not provided (unless context_type and context_id are given).

context_typestring

The type of context resource (e.g., "business")

context_idstring uuid

The ID of the context resource. Must be provided with context_type.

thread_idstring uuid

Optional agent thread ID in which to execute the agent run

Response

agent run created within existing agent thread

objectstring required

Object type identifier.

idstring uuid required

Unique identifier for the agent run.

created_atstring date-time required

Timestamp when the agent run record was created.

updated_atstring date-time required

Timestamp when the agent run record was last updated.

status'running' | 'completed' | 'error' | 'interrupted' required

Current lifecycle status of the agent run.

thread_idstring uuid

Identifier of the agent thread this run belongs to.

agentstring

Agent type that produced this run (for example, cip_orchestrator).

started_atstring date-time nullable

Timestamp when the agent run started.

ended_atstring date-time nullable

Timestamp when the agent run finished.

Changes