Agents

Replace an agent

Replace an agent's definition, creating the next immutable version. Existing sessions keep their pinned version.

put/v1/agents/{agent_id}

Request

agent_idstring required

descriptionstring nullable

Optional description for your own reference.

instructionsstring required

The agent's system instructions.

modelstring nullable

A model id from GET /v1/models. Leave null to use your plan's model.

namestring required

Display name.

expected_versioninteger

Reject the replacement unless this is still the current version.

Successful response.

archived_atstring date-time nullable required

created_atstring date-time required

descriptionstring nullable required

idstring uuid required

instructionsstring required

modelstring nullable required

namestring required

object'agent' required

updated_atstring date-time required

versioninteger required

No recorded changes to this operation across all 1 revision of this API.