Skip to main content
POST
Create Agent

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Schema for creating a new agent.

name
string
required
Required string length: 1 - 255
description
string | null
objective
string | null
permission_flags
Permission Flags · object | null
permissions
string[] | null
preset_id
string | null

Response

Successful Response

Schema for agent response (global, always includes api_key).

api_key
string
required
created_at
string<date-time>
required
created_by
string
required
description
string | null
required
id
string
required
is_active
boolean
required
last_used_at
string<date-time> | null
required
name
string
required
permissions
string[] | null
required
objective
string | null
permission_flags
Permission Flags · object | null
preset_id
string | null
Last modified on May 17, 2026