Skip to main content
POST
Publish an earlier version of an AI phone agent
Requires the phone:write scope. Every publish is numbered as a version: the number is in each publish response and in the agent’s version history in the dashboard. Send the number of an earlier one in the path to make its settings live again, exactly as they were. Calls that start afterwards use it, and it is recorded as a new version, so the agent’s history keeps every step. The draft is reset to that version, as after any publish: its unpublished changes are discarded and its revision moves, so a publish based on the draft as it was before is refused. Read the draft first if it has changes you want to keep. Instructions, knowledge, actions or other items deleted since that version was published are left out, not refused. Refusals carry a code beside the message, so your code can branch on the reason: Calls already in progress finish with the settings they started with. Agents on an older voice runtime have no drafts or versions, so the request returns 400 for them.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

phone_agent_id
string
required
version
integer
required

The version to put live again, as numbered when it was published.

Required range: 1 <= x <= 9007199254740991

Response

Default Response

agent_id
string
required
version
integer
required
Required range: -9007199254740991 <= x <= 9007199254740991
revision
integer
required
Required range: -9007199254740991 <= x <= 9007199254740991