Create agent

Create an agent configuration that defines the model, instructions, reasoning effort, and tools the agent can use.

The tool_ids parameter accepts IDs for any tool type, including agent-as-tools. When including agent-as-tools, the sub-agents and their tool wrappers must already exist before creating the supervisor agent.

For details on building multi-agent workflows, see Agent as tool.

Body Params
string
required
string
required
array | null
deprecated
array | null
string
required
ReasoningEffort | null
Defaults to medium
number
Defaults to 0.6
Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json