Agents
Update agent
Updates an agent definition. Only provided fields are changed.
patch/agent/v1/agents/{id}
Path parameters
idstring required
Agent ID
Request body
namestring
Updated agent display name
descriptionstring nullable
Updated agent description. Pass null to clear if supported by the client.
instructionsstring
Updated system instructions that guide agent behavior
modelstring
Model identifier the agent should use for future runs
vaultIdsstring[] nullable
Vault IDs the agent can access directly. Pass null to clear.
vaultGroupsstring[] nullable
Vault group IDs the agent can access. Pass null to clear.
enabledToolsstring[] nullable
Allowlist of tools the agent can use. Mutually exclusive with disabledTools — set one or the other, not both. Pass null to clear.
disabledToolsstring[] nullable
Denylist of tools the agent cannot use. Mutually exclusive with enabledTools — set one or the other, not both. Pass null to clear.
sandboxobject nullable
Sandbox configuration override for future agent runs. Pass null to clear.
Response
Updated agent
idstring
namestring
descriptionstring nullable
instructionsstring
modelstring
vaultIdsstring[] nullable
vaultGroupsstring[] nullable
enabledToolsstring[] nullable
disabledToolsstring[] nullable
sandboxobject nullable
isActiveboolean
createdAtstring date-time
updatedAtstring date-time