Update Agent

PUT

/api/v3/organizations/{organisation}/ai/agents/{agentId}

curl --request PUT \
  --url https://dashboard.quantcdn.io/api/v3/organizations/example/ai/agents/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0 \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "name": "example", "description": "example", "group": "example", "systemPrompt": "example", "temperature": 1, "modelId": "example", "maxTokens": 1, "allowedTools": [ "example" ], "allowedCollections": [ "example" ], "assignedSkills": [ "example" ], "longContext": true, "reasoningEffort": "low", "guardrailPreset": "official", "mcpServers": [ { "server": "example", "tools": [ "example" ] } ], "filterPolicies": [ "example" ] }'

• QuantCDN Public Cloud
• QuantGov Cloud

Updates an existing AI agent configuration. All fields except agentId, organizationId, createdAt, and createdBy can be updated.

Authorizations

• BearerAuth

Parameters

Path Parameters

organisation

required

string

The organisation ID

agentId

required

string format: uuid

The agent ID

Request Body^required

Media typeapplication/json

object

name

string

description

string

group

string

systemPrompt

string

temperature

number

<= 1

modelId

string

maxTokens

integer

>= 1 <= 200000

allowedTools

Array<string>

allowedCollections

Array<string>

assignedSkills

Skill IDs to assign to this agent

Array<string>

longContext

Enable 1M context window support

boolean

reasoningEffort

Reasoning effort (Anthropic effort). Must be one of the levels the model lists in capabilities.effortLevels. Unset uses the caller or model default. null clears it.

string

nullable

Allowed values: low medium high xhigh max

guardrailPreset

Guardrail preset name

string

nullable

Allowed values: official official-sensitive protected

mcpServers

Registered MCP servers to attach. The agent gets the tools of each server in dashboard chat and in QuantCode. On update, an empty array removes every attachment.

Array<object>

object

server

required

The registered server name

string

/^[a-z0-9][a-z0-9-]{0,62}$/

tools

Optional. Only these tools of the server. Omit for every tool the server allows; an empty array allows none.

Array<string>

filterPolicies

Filter policy IDs to apply to this agent’s inference requests

Array<string>

Responses

200

Agent updated successfully

Media typeapplication/json

object

success

boolean

agent

object

message

string

Example

{
  "success": true,
  "message": "Agent updated successfully"
}

400

Invalid request parameters

403

Access denied

404

Agent not found

500

Failed to update agent