Flow Revision
Flows Revisions track every change made to a Flow resource. Revisions are automatically created when a Flow is created or updated. Each revision is read-only and immutable (cannot be updated or deleted).
For convenience, the latest Revision and latest published Revision can be fetched using the magic identifiers LatestPublished and LatestRevision in place of an integer.
Fetching the parent Flow resource will always return the latest Flow Revision.
Property nameTypePIIDescription
The unique string that we created to identify the Flow resource.
Pattern: ^FW[0-9a-fA-F]{32}$Min length: 34Max length: 34
The SID of the Account that created the Flow resource.
Pattern: ^AC[0-9a-fA-F]{32}$Min length: 34Max length: 34
The string that you assigned to describe the Flow.
JSON representation of flow definition.
The status of the Flow. Can be: draft or published.
Possible values: draftpublished
The latest revision number of the Flow's definition.
Description of change made in the revision.
Boolean if the flow definition is valid.
List of error in the flow definition.
date_createdstring<date-time>
date_updatedstring<date-time>
The absolute URL of the resource.
GET https://studio.twilio.com/v2/Flows/{Sid}/Revisions/{Revision}
Property nameTypeRequiredPIIDescription
The SID of the Flow resource to fetch.
Pattern: ^FW[0-9a-fA-F]{32}$Min length: 34Max length: 34
Specific Revision number or can be LatestPublished and LatestRevision.
_19// Download the helper library from https://www.twilio.com/docs/node/install
_19const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio";
_19// Find your Account SID and Auth Token at twilio.com/console
_19// and set the environment variables. See http://twil.io/secure
_19const accountSid = process.env.TWILIO_ACCOUNT_SID;
_19const authToken = process.env.TWILIO_AUTH_TOKEN;
_19const client = twilio(accountSid, authToken);
_19async function fetchFlowRevision() {
_19 const revision = await client.studio.v2
_19 .flows("FWXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX")
_19 console.log(revision.sid);
_16 "sid": "FWXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
_16 "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
_16 "initial_state": "Trigger"
_16 "friendly_name": "Test Flow",
_16 "status": "published",
_16 "commit_message": null,
_16 "date_created": "2017-11-06T12:00:00Z",
_16 "date_updated": null,
_16 "url": "https://studio.twilio.com/v2/Flows/FWaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Revisions/1"
GET https://studio.twilio.com/v2/Flows/{Sid}/Revisions
Property nameTypeRequiredPIIDescription
The SID of the Flow resource to fetch.
Pattern: ^FW[0-9a-fA-F]{32}$Min length: 34Max length: 34
Property nameTypeRequiredPIIDescription
How many resources to return in each list page. The default is 50, and the maximum is 1000.
Minimum: 1Maximum: 1000
The page index. This value is simply for client state.
Minimum: 0
The page token. This is provided by the API.
_18// Download the helper library from https://www.twilio.com/docs/node/install
_18const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio";
_18// Find your Account SID and Auth Token at twilio.com/console
_18// and set the environment variables. See http://twil.io/secure
_18const accountSid = process.env.TWILIO_ACCOUNT_SID;
_18const authToken = process.env.TWILIO_AUTH_TOKEN;
_18const client = twilio(accountSid, authToken);
_18async function listFlowRevision() {
_18 const revisions = await client.studio.v2
_18 .flows("FWaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa")
_18 .revisions.list({ limit: 20 });
_18 revisions.forEach((r) => console.log(r.sid));
_27 "previous_page_url": null,
_27 "next_page_url": null,
_27 "url": "https://studio.twilio.com/v2/Flows/FWaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Revisions?PageSize=50&Page=0",
_27 "first_page_url": "https://studio.twilio.com/v2/Flows/FWaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Revisions?PageSize=50&Page=0",
_27 "sid": "FWaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
_27 "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
_27 "friendly_name": "Test Flow",
_27 "status": "published",
_27 "commit_message": null,
_27 "date_created": "2017-11-06T12:00:00Z",
_27 "date_updated": "2017-11-06T12:00:00Z",
_27 "url": "https://studio.twilio.com/v2/Flows/FWaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Revisions/1"