Phone Numbers

Publish call flow

Changed on

Publishes the working draft, making it the live call flow for the phone number. This changes live inbound routing immediately. Runs full validation, which is stricter than the lenient validation a draft save runs, so a draft that saved successfully can still fail to publish; the whole publish rolls back if validation fails. Publishing consumes the draft, so the line is left with no draft afterwards.

post/v2/api/numbers/{number}/call_flow/publish

Request

  • Base URL
    https://api.withallo.com
  • URL
    https://api.withallo.com/v2/api/numbers/{number}/call_flow/publish
  • Auth
    API key in header Authorization

Path parameters

numberstring required
Example:+14155551234

Allo phone number in E.164 format

Request body

lock_versioninteger required

The lock_version of the draft you are publishing.

Response

The published call flow

Example response

{
  "data": {
    "id": "cflv-abc123",
    "flow_id": "cflw-abc123",
    "version": 3,
    "status": "PUBLISHED",
    "schema_version": 1,
    "engine_subset": "FULL_FLOW",
    "number": "+14155551234",
    "confirmation_url": "https://app.withallo.com/call-flow-draft/cflv-abc123",
    "entry_node_id": "node-22"
  }
}

Changes