Skip to main content
POST
Create or register an agent

Authorizations

Authorization
string
header
required

API key authentication. Include your API key in the Authorization header as Bearer <api_key>.

Headers

Idempotency-Key
string

Unique key for idempotent requests (24-hour cache)

Body

application/json
customerId
string
required

Parent customer ID

externalId
string
required

External identifier (used for idempotent registration)

name
string

Agent name

status
enum<string>
Available options:
active,
paused,
disabled
limits
object
policy
object

Spending policy controls

metadata
object

Response

Agent created

id
string
required

Unique agent ID

name
string
required

Agent name

status
enum<string>
required

Agent status

Available options:
active,
paused,
disabled
customerId
string | null

Parent customer ID

externalId
string | null

External identifier for the agent

limits
object
policy
object

Spending policy controls

metadata
object
createdAt
string<date-time> | null