Upsert Agent Overlay
PUT
/api/v3/organizations/{organisation}/ai/agents/{agentId}/overlay
const url = 'https://dashboard.quantcdn.io/api/v3/organizations/example/ai/agents/example/overlay';const options = { method: 'PUT', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"modelId":"example","temperature":1,"maxTokens":1,"disabledSkills":["example"],"additionalSkills":["example"],"additionalTools":["example"],"disabledTools":["example"],"systemPromptAppend":"example","allowedCollections":["example"],"guardrailPreset":"official","version":1}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request PUT \ --url https://dashboard.quantcdn.io/api/v3/organizations/example/ai/agents/example/overlay \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "modelId": "example", "temperature": 1, "maxTokens": 1, "disabledSkills": [ "example" ], "additionalSkills": [ "example" ], "additionalTools": [ "example" ], "disabledTools": [ "example" ], "systemPromptAppend": "example", "allowedCollections": [ "example" ], "guardrailPreset": "official", "version": 1 }'Creates or replaces the per-organisation overlay for a global agent. PUT is full replacement — omitted optional fields are removed. Include version from a prior GET to enable compare-and-swap (409 on conflict). Omit for last-writer-wins.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”organisation
required
string
The organisation ID
agentId
required
string
Global agent identifier
Request Bodyrequired
Section titled “Request Bodyrequired”Media typeapplication/json
object
modelId
Override the base agent’s model
string
temperature
Override temperature
number
maxTokens
Override max tokens
integer
disabledSkills
Global skill IDs to exclude
Array<string>
additionalSkills
Org-owned skill IDs to add
Array<string>
additionalTools
Tool names to add
Array<string>
disabledTools
Tool names to remove
Array<string>
systemPromptAppend
Text appended to base system prompt
string
allowedCollections
Vector DB collections
Array<string>
guardrailPreset
Guardrail preset
string
version
Current version for optimistic concurrency
integer
Responses
Section titled “Responses”Overlay created or updated
Media typeapplication/json
object
overlay
object
Examplegenerated
{ "overlay": {}}Invalid request parameters
Access denied
Not a global agent
Version conflict — overlay was modified concurrently
Failed to save overlay