Skip to main content
POST
Create a new agent

Headers

x-user-id
string
required

Caller's user ID. Temporary header-based identity; will be replaced by JWT auth.

Body

application/json

Request body for creating a new agent.

name
string
required

Display name of the agent.

system_prompt
string
default:You're a helpful assistant.

Base system prompt fed to the agent.

context_config
ContextConfig · object

Context-window management configuration.

react_config
ReActConfig · object

ReAct loop configuration.

Response

Successful Response

Response body after creating an agent.

agent_id
string
required

Server-assigned agent identifier.