Skip to main content
GET
Get call flow draft
Required scope: PHONE_NUMBERS_READ

Behavior

Returns the working draft of a phone number’s call flow. The {number} path parameter is the Allo phone number in E.164 format (e.g. +14155551234). Unlike Get call flow with ?status=draft, this endpoint does not fall back to the published flow (or the legacy-IVR synthesis) when no draft exists — it returns 404 CALL_FLOW_DRAFT_NOT_FOUND. The response includes a confirmation_url — the link where a signed-in user reviews and publishes this draft. To publish it directly instead, call Publish call flow with the lock_version from this response.
Prefer this endpoint at the start of an edit cycle. GET …/call_flow?status=draft returns 200 with the published version when there is no draft, so a caller can end up holding the published lock_version — which then fails POST …/call_flow/publish with CALL_FLOW_STALE_LOCK. This endpoint makes “no draft” an explicit 404 instead.

Errors

  • 404 CALL_FLOW_DRAFT_NOT_FOUND — the number has no working draft. Create one with PUT /v2/api/numbers/{number}/call_flow/draft.
  • 404 PHONE_NUMBER_NOT_FOUND — the number is not one of your account’s numbers. List them with GET /v2/api/numbers.

Authorizations

Authorization
string
header
required

Path Parameters

number
string
required

Allo phone number in E.164 format

Example:

"+14155551234"

Response

The working draft

data
object

A version of a phone number's call flow.