Skip to main content
POST
Create Agent Session

Authorizations

Authorization
string
header
required

API key authentication

Body

application/json
agent_id
string<uuid>
required

Parent agent ID

status
enum<string>

Session status

Available options:
running,
waiting_for_input,
processing_input,
completed,
failed
state
object

Session state data

metadata
object

Session metadata

error_message
string | null

Error message if session failed

Response

An agent execution session

An agent execution session

id
string<uuid>

Unique identifier

agent_id
string<uuid>

Parent agent ID

workspace_id
string<uuid>

Workspace ID

status
enum<string>

Session status

Available options:
running,
waiting_for_input,
processing_input,
completed,
failed
state
object

Session state data

metadata
object

Session metadata

error_message
string | null

Error message if session failed

created_at
string<date-time>

Creation timestamp

updated_at
string<date-time>

Last update timestamp