Skip to main content
POST
/
agents
Create Agent
curl --request POST \
  --url https://api.example.com/agents

​
Request Body

{
  "name": "CustomAgent",
  "description": "A custom agent for my use case",
  "system_prompt": "You are a helpful assistant specialized in...",
  "llm_config": {
    "model": "openai/gpt-4o",
    "temperature": 0.7,
    "max_tokens": 8192
  },
  "enable_planning": true,
  "enable_reflection": false,
  "enable_retrieval": false,
  "max_turns": 10
}

​
Response

Returns the created agent configuration with its generated ID. 
{
  "id": "CustomAgent",
  "name": "CustomAgent",
  "description": "A custom agent for my use case",
  "llm_config": { ... },
  "enable_planning": true,
  "enable_reflection": false,
  "enable_retrieval": false,
  "max_turns": 10,
  "tools": [],
  "sub_agents": []
}