Skip to main content
POST
Create Agent

Headers

Authorization
string | null

Body

application/json

Create a new agent.

name
string
required
Required string length: 1 - 255
status
enum<string> | null

Lifecycle states for an autonomous agent.

Available options:
draft,
active,
paused,
archived
persona_id
string<uuid> | null
llm_profile_id
string<uuid> | null
settings
Settings · object | null
device_ids
string<uuid>[]

Response

Successful Response

Agent detail/list item.

id
string<uuid>
required
organization_id
string<uuid>
required
name
string
required
status
enum<string>
required

Lifecycle states for an autonomous agent.

Available options:
draft,
active,
paused,
archived
persona_id
string<uuid> | null
required
llm_profile_id
string<uuid> | null
required
settings
Settings · object | null
required
devices
AgentDeviceRef · object[]
required
created_at
string<date-time>
required
updated_at
string<date-time>
required