How it works

The version boundary

Which settings a published version owns and restores on a rollback, and which settings edit live on the next call with no publish step.

Not every setting belongs to a version. The split is below.

Version-scoped

Held by the draft, live only once you publish, and restored exactly by a rollback:

  • system prompt, greeting, returning-caller greeting and outbound greeting;
  • tools;
  • variables, including which stored secret each secret variable points at;
  • knowledge base sources and their embeddings;
  • voice, language model, fallback model and speech-to-text model;
  • conversation, turn detection and caller memory settings;
  • safety guardrails and agent response guardrails;
  • pre-call, hang-up and post-call functions;
  • call timezone;
  • recording and disclosure settings, personal information redaction, telemetry content level.

Agent-scoped

Edits live, no publish involved, and unaffected by a version rollback:

  • name and description;
  • transcript retention;
  • call-handling settings, such as voicemail detection, keypad input and call limits;
  • the overflow forward number;
  • pronunciation and recognition keyterms;
  • phone number assignment, channels and the public share link.

Rolling back a version does not restore agent-scoped settings. And because they bypass publish, the validator checks them where they are written, not at publish time.

Changing a secret

A secret's value belongs to the version you set it on. Setting it on a draft gives that draft its own copy, and the live version keeps its value until you publish the draft.

On this page