Skip to main content
POST
Create Agent

Authorizations

Authorization
string
header
required

API key authentication

Body

application/json
name
string
required

Agent name

Required string length: 1 - 255
description
string | null

Agent description

execution_endpoint
object | null

Execution endpoint configuration

Response

An AI agent with configurable settings

An AI agent with configurable settings

id
string<uuid>

Unique identifier

workspace_id
string<uuid>

Workspace ID

name
string

Agent name

Required string length: 1 - 255
description
string | null

Agent description

config_id
string<uuid> | null

Current active config ID

status
enum<string> | null

Agent status based on latest session

Available options:
running,
waiting_for_input,
completed,
failed
execution_endpoint
object | null

Execution endpoint configuration

created_at
string<date-time>

Creation timestamp

updated_at
string<date-time>

Last update timestamp