Call Flows

Deploy call flow version

Makes one saved Call Flow version active, selected by document version or version ID. Use it after updating a visual flow when that revision is ready to handle calls; updating the Call Flow saves a revision but does not replace this deployment step. Directly authored SWML Scripts do not use Call Flow versions.

Permissions

The API token used to authenticate must have the following scope(s) enabled to make a successful request: Voice, Messaging, Fax, or Video.

Learn more about API scopes.

post/api/fabric/resources/call_flow/{id}/versions

Path parameters

idstring required

The unique identifier of the Call Flow.

Request body

OR

Example request

{
  "document_version": 2
}

Response

The request has succeeded and a new resource has been created as a result.

idstring uuid required

Universal Unique Identifier.

created_atstring required

The creation timestamp.

updated_atstring required

The last update timestamp.

document_versioninteger required

The document version.

flow_dataobject

Call Flow Builder state, stored as an opaque JSON object.

relaymlobject

The calling SWML document deployed by this version. Uses calling SWML methods.

Example response

{
  "created_at": "2024-01-02T00:00:00Z",
  "updated_at": "2024-01-02T00:00:00Z",
  "document_version": 2,
  "flow_data": {},
  "relayml": {
    "version": "1.0.0",
    "sections": {
      "main": [
        {
          "play": {
            "url": "https://cdn.signalwire.com/swml/audio.mp3"
          }
        }
      ]
    }
  }
}

Changes

Changed in 33 of the 161 revisions of this API.139184448

  • e79dcc8b215012See the full diff
    • ▲

      the response's property type changed from no type to object for status

      response-property-type-changed

    • ○

      removed from the response property allOf list for the response status

      response-property-all-of-removed

    • ○

      added 'unevaluatedProperties' constraint to the response property for the status

      response-property-unevaluated-properties-added

    This revision also has 11 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

    • ▲

      the ///////// response's property type changed from no type to object for status

      response-property-type-changed

    • ▲

      the ///////////////////////// response's property type changed from array to no type for status

      response-property-type-changed

    • ▲

      the ///////////////////////// response's property type changed from array to no type for status

      response-property-type-changed

    • ▲

      the ////////////////////// response's property type changed from array to no type for status

      response-property-type-changed

    • ▲

      the ////////////////////// response's property type changed from array to no type for status

      response-property-type-changed

    • ▲

      the ///////////////////// response's property type changed from array to no type for status

      response-property-type-changed

    • ▲

      the ///////////////////// response's property type changed from array to no type for status

      response-property-type-changed

    • ▲

      the ////////////////// response's property type changed from array to no type for status

      response-property-type-changed

    • ▲

      the ////////////////// response's property type changed from array to no type for status

      response-property-type-changed

    • ▲

      the ///////////////////////// response's property type changed from array to no type for status

      response-property-type-changed

    • ▲

      the ///////////////////////// response's property type changed from array to no type for status

      response-property-type-changed

    • ▲

      the ////////////////////// response's property type changed from array to no type for status

      response-property-type-changed

    • ▲

      the ////////////////////// response's property type changed from array to no type for status

      response-property-type-changed

    • ▲

      the ///////////////////// response's property type changed from array to no type for status

      response-property-type-changed

    • ▲

      the ///////////////////// response's property type changed from array to no type for status

      response-property-type-changed

    • ▲

      the ////////////////// response's property type changed from array to no type for status

      response-property-type-changed

    • ▲

      the ////////////////// response's property type changed from array to no type for status

      response-property-type-changed

    • ▲

      the ///////// response's property type changed from no type to object for status

      response-property-type-changed

    • ▲

      the ///////////////////////// response's property type changed from array to no type for status

      response-property-type-changed

    • ▲

      the ///////////////////////// response's property type changed from array to no type for status

      response-property-type-changed

    • ▲

      the ////////////////////// response's property type changed from array to no type for status

      response-property-type-changed

    • ▲

      the ////////////////////// response's property type changed from array to no type for status

      response-property-type-changed

    • ▲

      the ///////////////////// response's property type changed from array to no type for status

      response-property-type-changed

    • ▲

      the ///////////////////// response's property type changed from array to no type for status

      response-property-type-changed

    • ▲

      the ////////////////// response's property type changed from array to no type for status

      response-property-type-changed

    • ▲

      the ////////////////// response's property type changed from array to no type for status

      response-property-type-changed

    • ▲

      the ///////////////////////// response's property type changed from array to no type for status

      response-property-type-changed

    • ▲

      the ///////////////////////// response's property type changed from array to no type for status

      response-property-type-changed

    • ▲

      the ////////////////////// response's property type changed from array to no type for status

      response-property-type-changed

    • ▲

      the ////////////////////// response's property type changed from array to no type for status

      response-property-type-changed

    • ▲

      the ///////////////////// response's property type changed from array to no type for status

      response-property-type-changed

    • ▲

      the ///////////////////// response's property type changed from array to no type for status

      response-property-type-changed

    • ▲

      the ////////////////// response's property type changed from array to no type for status

      response-property-type-changed

    • ▲

      the ////////////////// response's property type changed from array to no type for status

      response-property-type-changed

    This revision's changelog hit the recording limit, so it may not list every change to this endpoint.

    This revision also has 26 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

    • ○

      added subschema #1 subschema #2 subschema #3 subschema #4 to the ///////////////// response property anyOf list for the response status

      response-property-any-of-added

    • ○

      added subschema #1 subschema #2 subschema #3 subschema #4 to the ///////////////// response property anyOf list for the response status

      response-property-any-of-added

    • ○

      removed subschema #1 subschema #2 subschema #3 subschema #4 from the ///////////////// response property anyOf list for the response status

      response-property-any-of-removed

    • ○

      removed subschema #1 subschema #2 subschema #3 subschema #4 from the ///////////////// response property anyOf list for the response status

      response-property-any-of-removed

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

    • ○

      added subschema #1 subschema #2 subschema #3 subschema #4 to the ///////////////// response property anyOf list for the response status

      response-property-any-of-added

    • ○

      added subschema #1 subschema #2 subschema #3 subschema #4 to the ///////////////// response property anyOf list for the response status

      response-property-any-of-added

    • ○

      removed subschema #1 subschema #2 subschema #3 subschema #4 from the ///////////////// response property anyOf list for the response status

      response-property-any-of-removed

    • ○

      removed subschema #1 subschema #2 subschema #3 subschema #4 from the ///////////////// response property anyOf list for the response status

      response-property-any-of-removed

    This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 549e44d6120b6436See the full diff
    • ▲

      the response property /////////////////// became optional for the status

      response-property-became-optional

    • ▲

      the response property ///////////////// became optional for the status

      response-property-became-optional

    • ▲

      the response property ///////////////////// became optional for the status

      response-property-became-optional

    • ▲

      the response property /////////////////// became optional for the status

      response-property-became-optional

    • ▲

      the response property /////////////////// became optional for the status

      response-property-became-optional

    • ▲

      the response property ///////////////// became optional for the status

      response-property-became-optional

    • ▲

      the response property ///////////////////// became optional for the status

      response-property-became-optional

    • ▲

      the response property /////////////////// became optional for the status

      response-property-became-optional

    • ▲

      the response property /////////////////// became optional for the status

      response-property-became-optional

    • ▲

      the response property ///////////////// became optional for the status

      response-property-became-optional

    • ▲

      the response property ///////////////////// became optional for the status

      response-property-became-optional

    • ▲

      the response property /////////////////// became optional for the status

      response-property-became-optional

    • ▲

      the response property /////////////////// became optional for the status

      response-property-became-optional

    • ▲

      the response property ///////////////// became optional for the status

      response-property-became-optional

    • ▲

      the response property ///////////////////// became optional for the status

      response-property-became-optional

    • ▲

      the response property /////////////////// became optional for the status

      response-property-became-optional

    • ▲

      the response property /////////////////// became optional for the status

      response-property-became-optional

    • ▲

      the response property ///////////////// became optional for the status

      response-property-became-optional

    • ▲

      the response property ///////////////////// became optional for the status

      response-property-became-optional

    • ▲

      the response property /////////////////// became optional for the status

      response-property-became-optional

    • ▲

      the response property /////////////////// became optional for the status

      response-property-became-optional

    • ▲

      the response property ///////////////// became optional for the status

      response-property-became-optional

    • ▲

      the response property ///////////////////// became optional for the status

      response-property-became-optional

    • ▲

      the response property /////////////////// became optional for the status

      response-property-became-optional

    • ▲

      the response property /////////////////// became optional for the status

      response-property-became-optional

    • ▲

      the response property ///////////////// became optional for the status

      response-property-became-optional

    • ▲

      the response property ///////////////////// became optional for the status

      response-property-became-optional

    • ▲

      the response property /////////////////// became optional for the status

      response-property-became-optional

    • ▲

      the response property /////////////////// became optional for the status

      response-property-became-optional

    • ▲

      the response property ///////////////// became optional for the status

      response-property-became-optional

    • ▲

      the response property ///////////////////// became optional for the status

      response-property-became-optional

    • ▲

      the response property /////////////////// became optional for the status

      response-property-became-optional

    • ▲

      the /////////////////// response's property type changed from array to no type for status

      response-property-type-changed

    • ▲

      the ///////////////// response's property type changed from array to no type for status

      response-property-type-changed

    • ▲

      the ///////////////////// response's property type changed from array to no type for status

      response-property-type-changed

    • ▲

      the /////////////////// response's property type changed from array to no type for status

      response-property-type-changed

    • ▲

      the /////////////////// response's property type changed from array to no type for status

      response-property-type-changed

    • ▲

      the ///////////////// response's property type changed from array to no type for status

      response-property-type-changed

    • ▲

      the ///////////////////// response's property type changed from array to no type for status

      response-property-type-changed

    • ▲

      the /////////////////// response's property type changed from array to no type for status

      response-property-type-changed

    • ▲

      the /////////////////// response's property type changed from array to no type for status

      response-property-type-changed

    • ▲

      the ///////////////// response's property type changed from array to no type for status

      response-property-type-changed

    • ▲

      the ///////////////////// response's property type changed from array to no type for status

      response-property-type-changed

    • ▲

      the /////////////////// response's property type changed from array to no type for status

      response-property-type-changed

    • ▲

      the /////////////////// response's property type changed from array to no type for status

      response-property-type-changed

    • ▲

      the ///////////////// response's property type changed from array to no type for status

      response-property-type-changed

    • ▲

      the ///////////////////// response's property type changed from array to no type for status

      response-property-type-changed

    • ▲

      the /////////////////// response's property type changed from array to no type for status

      response-property-type-changed

    • ▲

      the /////////////////// response's property type changed from array to no type for status

      response-property-type-changed

    • ▲

      the ///////////////// response's property type changed from array to no type for status

      response-property-type-changed

    • ▲

      the ///////////////////// response's property type changed from array to no type for status

      response-property-type-changed

    • ▲

      the /////////////////// response's property type changed from array to no type for status

      response-property-type-changed

    • ▲

      the /////////////////// response's property type changed from array to no type for status

      response-property-type-changed

    • ▲

      the ///////////////// response's property type changed from array to no type for status

      response-property-type-changed

    • ▲

      the ///////////////////// response's property type changed from array to no type for status

      response-property-type-changed

    • ▲

      the /////////////////// response's property type changed from array to no type for status

      response-property-type-changed

    • ▲

      the /////////////////// response's property type changed from array to no type for status

      response-property-type-changed

    • ▲

      the ///////////////// response's property type changed from array to no type for status

      response-property-type-changed

    • ▲

      the ///////////////////// response's property type changed from array to no type for status

      response-property-type-changed

    • ▲

      the /////////////////// response's property type changed from array to no type for status

      response-property-type-changed

    • ▲

      the /////////////////// response's property type changed from array to no type for status

      response-property-type-changed

    • ▲

      the ///////////////// response's property type changed from array to no type for status

      response-property-type-changed

    • ▲

      the ///////////////////// response's property type changed from array to no type for status

      response-property-type-changed

    • ▲

      the /////////////////// response's property type changed from array to no type for status

      response-property-type-changed

    • ○

      added subschema #2 to the /////////////////// response property anyOf list for the response status

      response-property-any-of-added

    • ○

      added subschema #2 to the ///////////////// response property anyOf list for the response status

      response-property-any-of-added

    • ○

      added subschema #2 to the ///////////////////// response property anyOf list for the response status

      response-property-any-of-added

    • ○

      added subschema #2 to the /////////////////// response property anyOf list for the response status

      response-property-any-of-added

    • ○

      added subschema #2 to the /////////////////// response property anyOf list for the response status

      response-property-any-of-added

    • ○

      added subschema #2 to the ///////////////// response property anyOf list for the response status

      response-property-any-of-added

    • ○

      added subschema #2 to the ///////////////////// response property anyOf list for the response status

      response-property-any-of-added

    • ○

      added subschema #2 to the /////////////////// response property anyOf list for the response status

      response-property-any-of-added

    • ○

      added subschema #2 to the /////////////////// response property anyOf list for the response status

      response-property-any-of-added

    • ○

      added subschema #2 to the ///////////////// response property anyOf list for the response status

      response-property-any-of-added

    • ○

      added subschema #2 to the ///////////////////// response property anyOf list for the response status

      response-property-any-of-added

    • ○

      added subschema #2 to the /////////////////// response property anyOf list for the response status

      response-property-any-of-added

    • ○

      added subschema #2 to the /////////////////// response property anyOf list for the response status

      response-property-any-of-added

    • ○

      added subschema #2 to the ///////////////// response property anyOf list for the response status

      response-property-any-of-added

    • ○

      added subschema #2 to the ///////////////////// response property anyOf list for the response status

      response-property-any-of-added

    • ○

      added subschema #2 to the /////////////////// response property anyOf list for the response status

      response-property-any-of-added

    • ○

      added subschema #2 to the /////////////////// response property anyOf list for the response status

      response-property-any-of-added

    • ○

      added subschema #2 to the ///////////////// response property anyOf list for the response status

      response-property-any-of-added

    • ○

      added subschema #2 to the ///////////////////// response property anyOf list for the response status

      response-property-any-of-added

    • ○

      added subschema #2 to the /////////////////// response property anyOf list for the response status

      response-property-any-of-added

    • ○

      added subschema #2 to the /////////////////// response property anyOf list for the response status

      response-property-any-of-added

    • ○

      added subschema #2 to the ///////////////// response property anyOf list for the response status

      response-property-any-of-added

    • ○

      added subschema #2 to the ///////////////////// response property anyOf list for the response status

      response-property-any-of-added

    • ○

      added subschema #2 to the /////////////////// response property anyOf list for the response status

      response-property-any-of-added

    • ○

      added subschema #2 to the /////////////////// response property anyOf list for the response status

      response-property-any-of-added

    • ○

      added subschema #2 to the ///////////////// response property anyOf list for the response status

      response-property-any-of-added

    • ○

      added subschema #2 to the ///////////////////// response property anyOf list for the response status

      response-property-any-of-added

    • ○

      added subschema #2 to the /////////////////// response property anyOf list for the response status

      response-property-any-of-added

    • ○

      added subschema #2 to the /////////////////// response property anyOf list for the response status

      response-property-any-of-added

    • ○

      added subschema #2 to the ///////////////// response property anyOf list for the response status

      response-property-any-of-added

    • ○

      added subschema #2 to the ///////////////////// response property anyOf list for the response status

      response-property-any-of-added

    • ○

      added subschema #2 to the /////////////////// response property anyOf list for the response status

      response-property-any-of-added

    • ○

      added subschema #1 subschema #2 subschema #3 subschema #4 to the ///////////////// response property anyOf list for the response status

      response-property-any-of-added

    • ○

      added subschema #1 subschema #2 subschema #3 subschema #4 to the ///////////////// response property anyOf list for the response status

      response-property-any-of-added

    • ○

      removed subschema #1 subschema #2 subschema #3 subschema #4 from the ///////////////// response property anyOf list for the response status

      response-property-any-of-removed

    • ○

      removed subschema #1 subschema #2 subschema #3 subschema #4 from the ///////////////// response property anyOf list for the response status

      response-property-any-of-removed

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

    • ●

      removed the optional property //////////////// from the response with the status

      response-optional-property-removed

    • ●

      removed the optional property //////////////// from the response with the status

      response-optional-property-removed

    • ●

      removed the optional property //////////////// from the response with the status

      response-optional-property-removed

    • ●

      removed the optional property //////////////// from the response with the status

      response-optional-property-removed

    This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

    • ○

      added the optional property ////////// to the response with the status

      response-optional-property-added

    • ○

      added the optional property ////////// to the response with the status

      response-optional-property-added

    • ○

      added the optional property ////////// to the response with the status

      response-optional-property-added

    • ○

      added the optional property ////////// to the response with the status

      response-optional-property-added

    • ○

      added the optional property ////////// to the response with the status

      response-optional-property-added

    • ○

      added the optional property ////////// to the response with the status

      response-optional-property-added

    • ●

      removed the optional property ////////// from the response with the status

      response-optional-property-removed

    • ●

      removed the optional property ////////// from the response with the status

      response-optional-property-removed

    • ●

      removed the optional property ////////// from the response with the status

      response-optional-property-removed

    • ●

      removed the optional property ////////// from the response with the status

      response-optional-property-removed

    • ●

      removed the optional property ////////// from the response with the status

      response-optional-property-removed

    • ●

      removed the optional property ////////// from the response with the status

      response-optional-property-removed

    • ○

      added the optional property ////////// to the response with the status

      response-optional-property-added

    • ○

      added the optional property ////////// to the response with the status

      response-optional-property-added

    • ○

      added the optional property ////////// to the response with the status

      response-optional-property-added

    • ○

      added the optional property ////////// to the response with the status

      response-optional-property-added

    • ○

      added the optional property ////////// to the response with the status

      response-optional-property-added

    • ○

      added the optional property ////////// to the response with the status

      response-optional-property-added

    • ○

      the response's property default value changed from gcloud_speech_v2_async to deepgram:nova-3 for the status

      response-property-default-value-changed

    • ○

      the response's property default value changed from gcloud_speech_v2_async to deepgram:nova-3 for the status

      response-property-default-value-changed

    This revision also has 42 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Of the 161 revisions, 3 have a changelog that could not be searched.