Menu

Expand
Rate this page:

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.

FlowRevision properties

Resource Properties in REST API format
sid
sid<FW> Not PII

The unique string that we created to identify the Flow resource.

account_sid
sid<AC> Not PII

The SID of the Account that created the Flow resource.

friendly_name
string Not PII

The string that you assigned to describe the Flow.

definition
object Not PII

JSON representation of flow definition.

status
enum:status Not PII

The status of the Flow. Can be: draft or published.

revision
integer Not PII

The latest revision number of the Flow's definition.

commit_message
string Not PII

Description of change made in the revision.

valid
boolean Not PII

Boolean if the flow definition is valid.

errors
object[] Not PII

List of error in the flow definition.

date_created
date_time<iso8601> Not PII

The date and time in GMT when the resource was created specified in ISO 8601 format.

date_updated
date_time<iso8601> Not PII

The date and time in GMT when the resource was last updated specified in ISO 8601 format.

url
url Not PII

The absolute URL of the resource.

Fetch a FlowRevision resource

get
https://studio.twilio.com/v2/Flows/{Sid}/Revisions/{Revision}
Parameters
Parameters in REST API format
sid
Path
get sid<FW> Not PII

The SID of the Flow resource to fetch.

revision
Path
get string Not PII

Specific Revision number or can be LatestPublished and LatestRevision.

Example 1
Loading Code Sample...
        
        

        Fetch Flow Revision

        Read multiple FlowRevision resources

        get
        https://studio.twilio.com/v2/Flows/{Sid}/Revisions
        Parameters
        Parameters in REST API format
        sid
        Path
        get sid<FW> Not PII

        The SID of the Flow resource to fetch.

        Example 1
        Loading Code Sample...
              
              

              Read Flow Revisions

              Rate this page:

              Need some help?

              We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd by visiting Twilio's Stack Overflow Collective or browsing the Twilio tag on Stack Overflow.

              Loading Code Sample...
                    
                    
                    

                    Thank you for your feedback!

                    Please select the reason(s) for your feedback. The additional information you provide helps us improve our documentation:

                    Sending your feedback...
                    🎉 Thank you for your feedback!
                    Something went wrong. Please try again.

                    Thanks for your feedback!

                    thanks-feedback-gif