Skip to main content
Agents are workspace-defined automations. Each agent runs a task on a schedule or on demand, and may pause mid-run to request human sign-off before continuing. Approval requests surface in the Approvals queue. By the end of this page you will know which endpoints exist, the agent lifecycle, and what run statuses you can observe.

​
An agent in shape

​
Endpoints

List all agents in a workspace. Create a new agent (starts inactive). Fetch a single agent by id. Activate the agent so it begins runs. Deactivate the agent — no new runs are started. Paginated run history for the agent.

​
Lifecycle

Deactivating an agent stops new runs but lets in-flight runs complete. Pending approval records remain actionable.

​
Run statuses

Run history is paginated newest-first: GET /agents/{id}/runs accepts limit (default 20, max 100) and cursor. See Pagination for the cursor protocol.

​
Common errors

Approvals

Review and action approval requests that agents surface during a run.