Update prompt
Replace the current draft version's system prompt IN ITS ENTIRETY. The prompt is for things that apply to every tool, persona, voice persona, escalation policy. **Behavioural rules that only apply to one tool live in that tool's `description`, NOT here.** Don't duplicate tool-specific behaviour. Use Australian English. Pass the FULL new prompt body, partial patches aren't supported. Differs from `edit_system_prompt`: this is a full replace, for a one-line tweak or a single-section change, use edit_system_prompt (a targeted find/replace span) instead, which is cheaper and faster. Every prompt you write must meet the prompt guide (in the app it is in your system message; over the MCP, call read_guide with 'system-prompt'). In short: open with who the agent is; say once that every word is spoken to the caller; write behaviour as plain prose, said positively with its reason, at normal volume; give the business's never-rules their own short paragraph; say when the call ends and when to search the knowledge base; add three to five `<example>` blocks with every number in spoken form (`sixty dollars`, not `$60`), each ending on the line said before a tool runs, never with a tool call written as text. Never hand-write a guardrail block or a second identity lock: the platform adds its own safety rules above the prompt. The validator does not lint prompt quality, so check each piece yourself before publishing.
Authorization
bearerAuth A personal access token from Settings > API tokens.
In: header
Header Parameters
A key you choose, such as a UUID, that makes this POST safe to retry. Within 24 hours the same key and request answers with the first successful answer and runs nothing, the same key with a different request answers 422 idempotency_key_reused, and a key whose request is still running answers 409 idempotency_key_in_use. A failed request keeps nothing, so the same key runs it again.
1 <= length <= 255Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
curl -X POST "https://example.com/operations/update_system_prompt" \ -H "Content-Type: application/json" \ -d '{ "systemPrompt": "string", "agent": "string" }'{
"length": 0,
"property1": null,
"property2": null
}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}Update my preferences POST
Change your own preferences. Pass only what you want to change. builderApprovalDefault can be set to 'review' (every change waits for approval) or 'plan' (read and propose only); voiceInput shows or hides the dictation button; askBeforePaidTestRuns: true turns on the confirmation before paid test runs. Loosening a safeguard (approval 'auto', or askBeforePaidTestRuns false) is refused: you change those yourself in Settings → Preferences. The theme is set per device in the app and cannot be changed here.
Update test profile POST
Edit a test profile, rename it or replace either variable section. The two sections are the call-time split: mainAgentVariables go to the agent under test; testingAgentVariables are what the simulated caller states on the call. Each section you send REPLACES that whole section (read the current values with list_test_profiles first); a section you omit is untouched. Scenarios attached to the profile pick the new values up on their next run.