update_agent
Idempotent
FULL-REPLACE update of an agent's draft (send every field to keep — this is PUT, not PATCH). Does not change the live published revision; publish_agent does.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"agent_id": "<agent_id>",
"name": "<name>",
"base_prompt": "<base_prompt>",
"model": "<model>"
},
"name": "update_agent"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | agent display name | |
| model | Yes | model id from the workspace's model catalog (GET /v1/models) | |
| voice | No | TTS voice id | |
| accent | No | speaking accent hint | |
| purpose | No | Required on tools that read data or reports; recommended on every tool. One sentence: what you are doing and why (for example "finding this caller's open ticket to answer them"). Building a report, dashboard, analytics or an export is a SautiDesk Pro feature done by the report tools, not by pulling records. | |
| agent_id | Yes | agent UUID | |
| base_prompt | Yes | system prompt defining persona and rules | |
| speech_style | No | speaking style hint | |
| max_call_minutes | No | hard per-call duration cap |