Twilio

Twilio Flows API

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

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}.

Documentation

📖
Documentation
https://www.twilio.com/docs/iam/api/account
📖
Documentation
https://www.twilio.com/blog/what-is-intelligent-virtual-assistant
📖
Documentation
https://www.twilio.com/docs/
📖
Documentation
https://www.twilio.com/docs/conversations
📖
Documentation
https://www.twilio.com/docs/add-ons/marketplace
📖
Documentation
https://www.twilio.com/docs/media
📖
Documentation
https://www.twilio.com/en-us/messaging
📖
Documentation
https://www.twilio.com/en-us/trusted-activation/verify
📖
Documentation
https://www.twilio.com/docs/video
📖
Documentation
https://www.twilio.com/en-us/voice
📖
Documentation
https://www.twilio.com/docs/lookup
📖
Documentation
https://www.twilio.com/docs/flex
📖
Documentation
https://www.twilio.com/docs/sendgrid

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/twilio/refs/heads/main/openapi/twilio-flows-api-openapi.yml
⚙
AsyncAPI
https://raw.githubusercontent.com/api-evangelist/twilio/refs/heads/main/asyncapi/twilio-asyncapi.yml

Other Resources

🔗
Pricing
https://www.twilio.com/en-us/messaging/pricing/conversations-api
🔗
Pricing
https://www.twilio.com/en-us/sms/pricing/us
🔗
Pricing
https://www.twilio.com/en-us/verify/pricing
🔗
Pricing
https://www.twilio.com/en-us/video/pricing
🔗
Pricing
https://www.twilio.com/en-us/voice/pricing/us
🔗
Pricing
https://www.twilio.com/en-us/user-authentication-identity/pricing/lookup
🔗
Pricing
https://www.twilio.com/en-us/flex/pricing
🔗
Pricing
https://www.twilio.com/en-us/products/email-api/pricing

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/twilio-flows-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

twilio-flows-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Twilio - Studio Flows API
  description: This is the public Twilio REST API.
  termsOfService: https://www.twilio.com/legal/tos
  contact:
    name: Twilio Support
    url: https://support.twilio.com
    email: support@twilio.com
  license:
    name: Apache 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0.html
  version: 1.52.0
servers:
- url: https://studio.twilio.com
tags:


# --- truncated at 32 KB (45 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/twilio/refs/heads/main/openapi/twilio-flows-api-openapi.yml