Create agent
Creates a new agent. If url is provided, a link source is created from that URL and training is queued automatically.
The agent is always created even if source setup or training fails — id is always returned. Check pendingSteps in the response to see which steps need to be retried:
ADD_SOURCE— the URL could not be added as a source. Add sources manually via the Sources API.TRAIN_AGENT— training could not be started. Trigger it manually viaPOST /agents/{agentId}/train.
When pendingSteps is absent, all steps succeeded.
Subject to plan agent limits — returns AGENT_LIMIT_REACHED (403) when the account has reached its maximum number of agents.
Authorizations
API key from your account settings
Body
Agent name
1 - 100"Support Bot"
Homepage URL of the product. The agent is pre-configured to answer questions about this website.
"https://example.com"
System prompt / instructions for the agent
AI model to use
gpt-4o, gpt-4o-mini, o4-mini, gpt-oss-120b, gpt-oss-20b, gpt-5, gpt-5.1, gpt-5.2, gpt-5.4, gpt-5.4-mini, gpt-5.4-nano, gpt-5.5, gpt-5.6-terra, gpt-5.6-luna, gpt-5-mini, gpt-5-nano, claude-opus-4-8, claude-opus-4-7, claude-opus-4-6, claude-sonnet-4-6, claude-opus-4-5, claude-haiku-4-5, claude-sonnet-4-5, gemini-2.5-pro, gemini-3-flash, gemini-3.1-flash-lite, gemini-3.1-pro, gemini-3.5-flash, gemini-3.5-flash-lite, gemini-3.6-flash, grok-3, grok-3-mini, grok-4, DeepSeek-V3, DeepSeek-R1, DeepSeek-V4-Flash, Llama-4-Scout-17B-16E-Instruct, Llama-4-Maverick-17B-128E-Instruct-FP8, kimi-k2, mistral-medium-3.5, mistral-small-2603, glm-5.2 "gpt-5.1"
Model temperature (0–1)
0 <= x <= 10
Agent visibility (default: private)
public, private Response
Agent created
The agent ID
"5QHA6VB-DIAbBhxwqxfdi"
Steps that failed after the agent was created, absent when everything succeeded. ADD_SOURCE — the provided URL could not be added as a source; add sources manually via the Sources API. TRAIN_AGENT — training could not be started; trigger it manually via POST /agents/{agentId}/train.
ADD_SOURCE, TRAIN_AGENT 