Create an agent
Creates a new agent. An agent is an automation scoped to a use case that organizes related tasks.
Authorizations
Secret key (sk_live_...)
Headers
Optional key that makes the request idempotent. Retrying with the same key returns the original response instead of repeating the operation; keys expire after 24 hours. Any string up to 256 characters. See Idempotency.
256"550e8400-e29b-41d4-a716-446655440000"
Body
Response
Created
An agent object. Agents organize related tasks under a single use case.
Unique identifier for the agent, prefixed with agt_.
^agt_"agt_AbC123xYz456"
Always agent.
Display name for the agent.
Description of the agent's purpose.
Tasks associated with this agent.
ISO 8601 timestamp of when the resource was created.
"2026-08-24T12:00:00Z"
ISO 8601 timestamp of when the resource was last updated.
"2026-08-24T12:00:00Z"
Unique identifier for the API request. Include this when contacting support.