Renvoie le brouillon de travail du flux d'appel d'un numéro. Le paramètre de chemin est le numéro Allo au format E.164 (ex. +14155551234 ).
GET/v2/api/numbers/{number}/call_flow/draft
Comportement
Renvoie le brouillon de travail du flux d'appel d'un numéro. Le paramètre de chemin {number} est le numéro Allo au format E.164 (ex. +14155551234).
Contrairement à Récupérer le flux d'appel avec ?status=draft, cette route ne bascule pas sur le flux publié (ni sur la synthèse de l'IVR héritée) lorsqu'aucun brouillon n'existe — elle renvoie 404 CALL_FLOW_DRAFT_NOT_FOUND.
La réponse contient une confirmation_url — le lien où un utilisateur connecté vérifie et publie ce brouillon. Pour le publier directement, appelez Publier le flux d'appel avec la lock_version de cette réponse.
Erreurs
404 CALL_FLOW_DRAFT_NOT_FOUND — le numéro n'a aucun brouillon de travail. Créez-en un avec PUT /v2/api/numbers/{number}/call_flow/draft.
404 PHONE_NUMBER_NOT_FOUND — le numéro ne fait pas partie des numéros de votre compte. Listez-les avec GET /v2/api/numbers.
Autorisation
Authorizationstring · headerrequis
Api-Key ak_live_…
Paramètres de chemin
numberstringrequis
Allo phone number in E.164 format
Réponses
200The working draft
dataobject
A version of a phone number's call flow.
11 champs
idstring | null
The call flow version ID. Null for a synthesized (never-persisted) flow.
flow_idstring | null
The parent call flow ID. Null for a synthesized flow.
versioninteger
Monotonic version number within the flow.
statusenum<string>
DRAFT (working copy), PUBLISHED (live), or SYNTHESIZED (in-memory representation of a legacy IVR-only line).
DRAFTPUBLISHEDSYNTHESIZED
lock_versioninteger
Optimistic-concurrency token; pass it back on the next draft save.
schema_versioninteger
The call flow schema version this definition conforms to.
engine_subsetenum<string>
FULL_FLOW runs the whole tree on live calls. NESTED_IVR runs only the root phone menu: its keys that lead to a nested menu, a condition or a voicemail node do nothing.
NESTED_IVRFULL_FLOW
numberstring | null
E.164 of the line this flow routes. Null for a never-persisted SYNTHESIZED flow.
confirmation_urlstring | null
A link where a signed-in user reviews this draft and publishes it. Present only on a DRAFT (a PUBLISHED or SYNTHESIZED version has nothing to confirm). Use it when a person should approve the change; to go live without one, call POST /v2/api/numbers/{number}/call_flow/publish. Treat it as opaque: pass it through verbatim, and never construct or parse it.
entry_node_idstring
The id of the entry node in definition.nodes.
definitionobject
The call flow tree document (opaque; camelCase keys).