Get call flow draft
Phone Numbers
Get call flow draft
Returns the working draft of a phone number’s call flow. Unlike GET /v2/api/numbers/{number}/call_flow?status=draft, this endpoint does NOT fall back to the published flow when no draft exists — it returns 404 CALL_FLOW_DRAFT_NOT_FOUND. Use it to read a draft’s lock_version without risk of accidentally holding the published version’s lock.
GET
Get call flow draft
Required scope:
PHONE_NUMBERS_READBehavior
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 withPUT /v2/api/numbers/{number}/call_flow/draft.404 PHONE_NUMBER_NOT_FOUND— the number is not one of your account’s numbers. List them withGET /v2/api/numbers.