Agents

Create an agent

Creates a reusable agent without storing credentials. See agent configuration.

post/agents

Request

metadataobject nullable

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.

namestring nullable

A human-readable name for the agent. Omission or null leaves the agent unnamed.

modelstring required

The model to use for the agent. The requested model name is preserved.

The service tier used for model requests.

instructionsstring nullable

Additional instructions appended to the agent's default base instructions. Omit or set to null to add no custom instructions.

The created agent.

idstring required

The ID of the reusable agent.

object'agent' required

The object type. Always agent.

created_atinteger required

The Unix timestamp, in seconds, when the agent was created.

updated_atinteger required

The Unix timestamp, in seconds, when the agent was last updated.

namestring nullable required

A human-readable name for the agent, or null if it is unnamed.

metadataobject required

Custom string key-value pairs attached to the agent.

modelstring required

The requested model name used for inference.

The service-tier policy configured for an agent.

instructionsstring nullable required

Custom instructions appended to the agent's default base instructions.

Oct 29, 20260a26f104d35f Revision changes
- info
  added the new optional request property
- info
  added the optional property to the response with the status
Oct 28, 202681bec64c97ee Revision changes
- info
  added the new optional request property
- info
  added the optional property to the response with the status