v44

latestOpenAPI 3.1.0Proprietaryraw.githubusercontent.com2026-05-192301780.0 KB
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