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

Body for POST /v1/agents.

name
string
required
Required string length: 1 - 200
description
string | null
instructions
string | null
execution_mode
string | null
default:balanced
models
Models · object | null
knowledge_bases
string[]
skills
string[]
tool_categories
string[]
suggested_prompts
string[]
generate_runtime_key
boolean
default:true

Response

Successful Response

agent
V1AgentResponse · object
required
api_key
RuntimeKeyResponse · object | null

Runtime API key returned once after creation or rotation.