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, "guardrailPreset": "official", "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

guardrailPreset

Guardrail preset name

string

nullable

Allowed values: official official-sensitive protected

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