Operations
Operations

Update test profile

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.

POST
/operations/update_test_profile

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_test_profile" \  -H "Content-Type: application/json" \  -d '{    "profileId": "string",    "agent": "string"  }'
{}
{
  "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 prompt POST

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.

Edit KB text POST

Replace the text of a pasted-text knowledge-base source, keeping its name. The new text is embedded first and the old source is removed only once the new one is ready, so a failed read leaves the old text in place. The source gets a NEW id: use the `source.id` in the result for any later call. Refuses a website or file source (use `refresh_kb_source` or delete and re-add), a live version (create a draft first) and a version that is not the newest draft (409 with `latestVersion`). Embedding is metered like `add_text_kb_source`.