Twilio

Twilio Flows API

The Flows API from Twilio — 12 operation(s) for flows.

Documentation GitHub OpenAPI

Operations 19

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /v2/Flows/{FlowSid}/Executions List the executions of a Studio Flow · List execution #

Ask an LLM

“Which executions has my Studio Flow run recently?”

“Can I filter a Flow's executions to a date range?”

Tell an agent

List the executions of Flow {flow_sid}.

Show executions of Flow {flow_sid} created between {from} and {to}.

POST /v2/Flows/{FlowSid}/Executions Trigger a Studio Flow for a contact · Create execution #

Ask an LLM

“How do I start a Studio Flow from my own code instead of an inbound message?”

“Can I pass custom variables into a Flow when I trigger it?”

Tell an agent

Trigger Flow {flow_sid} to {to} from {from}.

Start Flow {flow_sid} for {to} from number {from} with parameters {parameters}.

GET /v2/Flows/{FlowSid}/Executions/{Sid} Look up one Flow execution · Fetch execution #

Ask an LLM

“Can I check the status of a single Studio Flow execution?”

“What does one execution record of a Flow tell me?”

Tell an agent

Show execution {sid} of Flow {flow_sid}.

Fetch the status of Flow {flow_sid} execution {sid}.

DELETE /v2/Flows/{FlowSid}/Executions/{Sid} Delete a Flow execution and its steps · Delete execution #

Ask an LLM

“Can I delete an execution record along with all of its steps?”

“What's the way to purge an old Studio Flow execution from history?”

Tell an agent destructive · confirm first

Delete execution {sid} from Flow {flow_sid}.

Purge Flow {flow_sid} execution {sid} and every step in it.

POST /v2/Flows/{FlowSid}/Executions/{Sid} End a running Flow execution · Update execution #

Ask an LLM

“Can I stop a Studio Flow execution that is stuck mid-flow?”

“Is ended the only status I can set on a running execution?”

Tell an agent destructive · confirm first

End execution {sid} of Flow {flow_sid}.

Set the status of Flow {flow_sid} execution {sid} to {status}.

GET /v2/Flows/{FlowSid}/Executions/{ExecutionSid}/Context Get the latest context of a Flow execution · Fetch execution context #

Ask an LLM

“Can I see the variables and widget data a Flow execution has collected so far?”

“Where do I read the most recent context for a whole execution?”

Tell an agent

Get the current context of execution {execution_sid} in Flow {flow_sid}.

Show the collected variables for Flow {flow_sid} execution {execution_sid}.

GET /v2/Flows/{FlowSid}/Executions/{ExecutionSid}/Steps List the steps an execution went through · List execution step #

Ask an LLM

“Which widgets did a Flow execution pass through, in order?”

“Can I trace every step of a single Studio execution?”

Tell an agent

List the steps of execution {execution_sid} in Flow {flow_sid}.

Trace every step Flow {flow_sid} took during execution {execution_sid}.

GET /v2/Flows/{FlowSid}/Executions/{ExecutionSid}/Steps/{Sid} Look up one step of a Flow execution · Fetch execution step #

Ask an LLM

“Can I inspect a single step of an execution by its SID?”

“What does one execution step record show about the widget transition?”

Tell an agent

Show step {sid} of execution {execution_sid} in Flow {flow_sid}.

Fetch execution step {sid} from Flow {flow_sid} run {execution_sid}.

GET /v2/Flows/{FlowSid}/Executions/{ExecutionSid}/Steps/{StepSid}/Context Get the context captured at one execution step · Fetch execution step context #

Ask an LLM

“Can I see what data a Flow held at one particular step?”

“Where do I read the context snapshot for a single execution step?”

Tell an agent

Get the context at step {step_sid} of execution {execution_sid} in Flow {flow_sid}.

Show the step-level context snapshot for step {step_sid} in Flow {flow_sid} run {execution_sid}.

POST /v2/Flows Create a new Studio Flow · Create flow #

Ask an LLM

“Can I create a Studio Flow from a JSON definition through the API?”

“Can I create a Flow as a draft rather than publishing it right away?”

Tell an agent

Create a Flow named {friendly_name} with status {status} from definition {definition}.

Create {friendly_name} as a new {status} Flow using {definition} with commit message {commit_message}.

GET /v2/Flows List my Studio Flows · List flow #

Ask an LLM

“Which Studio Flows exist on my account?”

“Can I page through all my Flows 50 at a time?”

Tell an agent

List all my Studio Flows.

Show my Flows {page_size} per page.

POST /v2/Flows/{Sid} Update or publish an existing Studio Flow · Update flow #

Ask an LLM

“Can I publish a draft Flow by changing its status?”

“Can I push a new JSON definition to a Flow that already exists?”

Tell an agent

Set existing Flow {sid} to status {status}.

Replace the definition of Flow {sid} with {definition} as {status} and note {commit_message}.

GET /v2/Flows/{Sid} Look up one Studio Flow · Fetch flow #

Ask an LLM

“Can I retrieve a single Flow and its current definition?”

“Is a given Studio Flow published or still a draft?”

Tell an agent

Show Studio Flow {sid}.

Fetch the current definition of Flow {sid}.

DELETE /v2/Flows/{Sid} Delete a Studio Flow · Delete flow #

Ask an LLM

“Can I permanently delete a Studio Flow I no longer need?”

“How do I remove an unused Flow from my account?”

Tell an agent destructive · confirm first

Delete Studio Flow {sid}.

Remove Flow {sid} from my account.

GET /v2/Flows/{Sid}/Revisions List the revision history of a Flow · List flow revision #

Ask an LLM

“Can I see every past revision of a Studio Flow?”

“Which versions of my Flow have been saved over time?”

Tell an agent

List the revisions of Flow {sid}.

Show the saved version history for Flow {sid}.

GET /v2/Flows/{Sid}/Revisions/{Revision} Get a specific revision of a Flow · Fetch flow revision #

Ask an LLM

“Can I pull up the latest published revision of a Flow?”

“Can I retrieve an older numbered revision of a Studio Flow?”

Tell an agent

Fetch revision {revision} of Flow {sid}.

Show the LatestPublished revision of Flow {sid} as {revision}.

POST /v2/Flows/Validate Validate a Flow definition before saving · Update flow validate #

Ask an LLM

“Can I check a Flow JSON definition for errors without creating the Flow?”

“Is there a dry-run check for Studio Flow definitions?”

Tell an agent

Validate the Flow definition {definition} for {friendly_name} with status {status}.

Dry-run check Flow JSON {definition} named {friendly_name} as {status} before I save it.

GET /v2/Flows/{Sid}/TestUsers See who can test a Flow's draft · Fetch test user #

Ask an LLM

“Which test users are allowed to try the draft version of my Flow?”

“Can I check the test user list on a Studio Flow?”

Tell an agent

Show the test users for Flow {sid}.

List who can test drafts of Flow {sid}.

POST /v2/Flows/{Sid}/TestUsers Set who can test a Flow's draft · Update test user #

Ask an LLM

“Can I let specific identities test a draft Flow before it goes live?”

“Can I replace the test user list on a Studio Flow?”

Tell an agent

Set the test users on Flow {sid} to {test_users}.

Allow {test_users} to test draft versions of Flow {sid}.

Twilio Flows API

Operations 19

Documentation

Specifications

Schemas & Data

Other Resources

Work with this as data

MCP server

Tools for apis

Call it yourself

Get an API key

OpenAPI Specification