Create agent
Create a new agent. The authenticated caller must have permission to create agents on the target team.
Authorizations
Body
Display name for the agent.
"Sales research agent"
ID of the LLM the agent runs on. Use GET /models to discover valid values.
"anthropic/claude-sonnet-4"
"Researches accounts and drafts outreach"
"You are a B2B sales research assistant."
Tools the agent can call. Each tool is an object whose shape depends on the tool type.
Resources attached to the agent.
Arbitrary key/value metadata stored on the agent.
ID of the folder to place the agent in.
"folder_91ab"
Whether the agent is active. Defaults to true.
Optional caller-supplied agent ID. When omitted, the server generates one.
ID of the team to create the agent under. When omitted, the agent is owned by the authenticated user.
"team_4f8c92ab"
Response
Agent created.
