Operations
Operations

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.

POST
/operations/update_system_prompt

Authorization

bearerAuth
AuthorizationBearer <token>

A personal access token from Settings > API tokens.

In: header

Header Parameters

Idempotency-Key?string

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.

Length1 <= length <= 255

Request 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
}