v1

latestOpenAPI 3.0.32026-07-267015229.9 KB

PALs

Publish PAL

Publishes the PAL Builder draft associated with this pal_id, making its content the live version used by new conversations, deployments, and public reads.

Call this after a draft-routed Patch PAL response. That response includes a publish_url you can use directly. Publishing preserves the live layers.conferencing configuration and keeps the draft row available for future Builder edits.

If the PAL has no Builder draft, the call is idempotent: Tavus returns the current live PAL. You can pass either the stable live PAL id or its underlying draft id, although integrations should normally keep and publish the stable live pal_id.

post/v2/pals/{pal_id}/publish

Response

The published live PAL. status is success.

status'success'

pal_idstring

The stable id of the live PAL that now contains the published draft content.

pal_namestring

The published PAL name.

system_promptstring

The published system prompt.

updated_atstring

The date and time when the live PAL was updated.

Example response

{
  "status": "success",
  "pal_id": "pcb7a34da5fe",
  "pal_name": "Life Coach",
  "system_prompt": "As a Life Coach, you are a dedicated professional who specializes in...",
  "updated_at": "2026-07-14T17:00:00.000000"
}