Ai agents
Update AI agent
PATCH
Update an AI agent's name, instructions, model, domains, signature and behaviour. Only sent fields change. Owner/admin.
bearer agents:writeheader
AuthorizationBearer <token>API key (rsl_live_…) from Settings → Developers.
Scope: agents:write
agentId*stringAI agent id. Never invent ids – list resources first.
Length
1 <= length <= 64application/json- body
name?stringLength
2 <= length <= 100description?stringLength
length <= 500instructions?stringFull system prompt (replaces the current one). Read agents_get first.
Length
length <= 500000model?|Model id from models_list, or default.
activeDomains?array<>Websites where this agent answers the chat widget.
Items
items <= 50emailSignature?stringHTML email signature.
Length
length <= 20000settings?sidebar?Success
application/json- response
id*stringname*stringisActive*booleandashboardUrl*stringchanged*array<string>curl -X PATCH "https://example.com/agents/string" \ -H "Content-Type: application/json" \ -d '{}'{ "id": "string", "name": "string", "isActive": true, "dashboardUrl": "string", "changed": [ "string" ]}