Operations
Operations

Set post-call analysis

Set this version's summary instructions for the post-call analysis. The analysis still writes a one-sentence summary of every call; these instructions say what else it must cover. Post-call functions read the summary as {{call_summary}}. Up to 1000 characters. The on/off switch for the whole analysis is agent-wide and is not set here. Works on a draft, or on a published latest version when you pass draftFrom.

POST
/operations/set_post_call_analysis

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/set_post_call_analysis" \  -H "Content-Type: application/json" \  -d '{    "summary": "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
}

Set overflow forward number POST

Set the agent's OVERFLOW FORWARD number, where a caller is transferred when every voice runtime machine is already on a call (the fleet answers and forwards instead of leaving them ringing). Resolution at call time: this number first, then the transfer_to_human destination, then an apology + hangup. Pass number: null to clear it. Agent-scoped (applies across versions), stored on agents.settings.overflowForwardNumber. Use when the user says 'send overflow calls to my mobile', 'set the busy fallback number', or 'clear the overflow number'.

Set post-call field POST

Add or replace one post-call field, matched by name. The post-call analysis fills each field from the call, in the same pass that writes the call summary, and post-call functions read the value as {{name}} in their inputs, requests and messages, and in their conditions. A field is {name, type, description, choices?}: type text, choice (the analysis picks one of `choices`, at least one), boolean (true or false) or number. The description says what to pull from the call, such as "The day and time the caller wants a callback". A value the call never gave is left empty. Names are snake_case, unique, and never a built-in post-call variable such as call_summary or customer_name. Up to 20 fields. Pass `previousName` to rename; functions that read the old name keep reading it until you change them with set_workflow_function. Works on a draft, or on a published latest version when you pass draftFrom.