Skip to main content
POST
Discard the draft of an AI phone agent
Requires the phone:write scope. The live settings and calls are not affected. An agent that was never published has no live settings to reset to, so the request returns 400.

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

Response

Default Response

agent_id
string
required
published
boolean
required

False until the agent is published for the first time.

revision
integer
required

Increases on every change to the draft. Send it back when publishing; compare it to tell whether the draft changed since it was read.

Required range: -9007199254740991 <= x <= 9007199254740991
has_unpublished_changes
boolean
required
live_version
integer | null
required

The version currently live; null until the first publish.

Required range: -9007199254740991 <= x <= 9007199254740991
config
object
required
field_changes
object
required

Who last changed each setting of the draft, and when.