Create an agent
Creates a reusable agent without storing credentials. See agent configuration.
Request body
Up to 16 string key-value pairs, with keys up to 64 and values up to 512 characters. Omission or null defaults to an empty map.
A human-readable name for the agent. Omission or null leaves the agent unnamed.
The model to use for the agent. The requested model name is preserved.
The service tier used for model requests.
Additional instructions appended to the agent's default base instructions. Omit or set to null to add no custom instructions.
Response
The created agent.
The ID of the reusable agent.
The object type. Always agent.
The Unix timestamp, in seconds, when the agent was created.
The Unix timestamp, in seconds, when the agent was last updated.
A human-readable name for the agent, or null if it is unnamed.
Custom string key-value pairs attached to the agent.
The requested model name used for inference.
The service-tier policy configured for an agent.
Custom instructions appended to the agent's default base instructions.