Get call flow draft
Numéros de téléphone
Récupérer le brouillon du flux d'appel
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
Scope requis :
PHONE_NUMBERS_READComportement
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.
Préférez cette route au début d’un cycle d’édition.
GET …/call_flow?status=draft renvoie 200 avec la version publiée lorsqu’il n’y a pas de brouillon, si bien qu’un client peut se retrouver avec le lock_version de la version publiée — ce qui échoue ensuite à POST …/call_flow/publish avec CALL_FLOW_STALE_LOCK. Cette route transforme « aucun brouillon » en un 404 explicite.Erreurs
404 CALL_FLOW_DRAFT_NOT_FOUND— le numéro n’a aucun brouillon de travail. Créez-en un avecPUT /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 avecGET /v2/api/numbers.