Twilio

Twilio Fleets API

The Fleets API from Twilio — 2 operation(s) for fleets.

Documentation GitHub OpenAPI

Operations 4

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

POST /v1/Fleets Create a Super SIM fleet · Create fleet #

Ask an LLM

“How do I group my Super SIMs into a fleet with shared settings?”

“Can I cap how many megabytes each SIM in a new fleet can use per billing period?”

Tell an agent

Create a fleet on network access profile {network_access_profile} named {unique_name}.

Create a fleet using profile {network_access_profile} with a data limit of {data_limit} MB per SIM.

GET /v1/Fleets List my Super SIM fleets · List fleet #

Ask an LLM

“Which Super SIM fleets are on my account?”

“Can I find the fleets that use a particular network access profile?”

Tell an agent

List my Super SIM fleets.

Show fleets tied to network access profile {network_access_profile}.

GET /v1/Fleets/{Sid} Look up one Super SIM fleet · Fetch fleet #

Ask an LLM

“Can I check the data limit and command URLs on one fleet?”

“What settings does a single Super SIM fleet have?”

Tell an agent

Fetch Super SIM fleet {sid}.

Show the configuration of fleet {sid}.

POST /v1/Fleets/{Sid} Change an existing Super SIM fleet's settings · Update fleet #

Ask an LLM

“Can I move an existing fleet to a different network access profile?”

“Can I raise the per-SIM data limit on a fleet I already have?”

Tell an agent

Switch fleet {sid} to network access profile {network_access_profile}.

Change the data limit on fleet {sid} to {data_limit} MB.

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:twilio-fleets-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

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

openapi: 3.2.0
info:
  title: Twilio - Supersim Fleets 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://supersim.twilio.com
tags:
- name: Fleets
paths:
  /v1/Fleets:
    servers:
    - url: https://supersim.twilio.com
    description: Configure shared settings inherited by all Super SIMs assigned to the Fleet
    x-twilio:
      defaultOutputProperties:
      - sid
      - unique_name
      - data_metering
      pathType: list
    post:
      description: Create a Fleet
      tags:
      - Fleets
      responses:
        '201':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/supersim.v1.fleet'
          description: Created
      security:
      - accountSid_authToken: []
      operationId: CreateFleet
      x-maturity:
      - Beta
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/CreateFleetRequest'
      summary: Create fleet
      x-summary-source: derived
    get:
      description: Retrieve a list of Fleets from your account.
      tags:
      - Fleets
      parameters:
      - name: NetworkAccessProfile
        in: query
        description: The SID or unique name of the Network Access Profile that controls which cellular networks the Fleet's SIMs can connect to.
        schema:
          type: string
      - name: PageSize
        in: query
        description: How many resources to return in each list page. The default is 50, and the maximum is 1000.
        schema:
          type: integer
          minimum: 1
          maximum: 1000
      - name: Page
        in: query
        description: The page index. This value is simply for client state.
        schema:
          type: integer
          minimum: 0
      - name: PageToken
        in: query
        description: The page token. This is provided by the API.
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListFleetResponse'
          description: OK
      security:
      - accountSid_authToken: []
      operationId: ListFleet
      x-maturity:
      - Beta
      summary: List fleet
      x-summary-source: derived
  /v1/Fleets/{Sid}:
    servers:
    - url: https://supersim.twilio.com
    description: Configure shared settings inherited by all Super SIMs assigned to the Fleet
    x-twilio:
      defaultOutputProperties:
      - sid
      - unique_name
      - data_metering
      pathType: instance
    get:
      description: Fetch a Fleet instance from your account.
      tags:
      - Fleets
      parameters:
      - name: Sid
        in: path
        description: The SID of the Fleet resource to fetch.
        schema:
          type: string
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/supersim.v1.fleet'
          description: OK
      security:
      - accountSid_authToken: []
      operationId: FetchFleet
      x-maturity:
      - Beta
      summary: Fetch fleet
      x-summary-source: derived
    post:
      description: Updates the given properties of a Super SIM Fleet instance from your account.
      tags:
      - Fleets
      parameters:
      - name: Sid
        in: path
        description: The SID of the Fleet resource to update.
        schema:
          type: string
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/supersim.v1.fleet'
          description: OK
      security:
      - accountSid_authToken: []
      operationId: UpdateFleet
      x-maturity:
      - Beta
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/UpdateFleetRequest'
      summary: Update fleet
      x-summary-source: derived
components:
  schemas:
    ListFleetResponse:
      type: object
      properties:
        fleets:
          type: array
          items:
            $ref: '#/components/schemas/supersim.v1.fleet'
        meta:
          type: object
          properties:
            first_page_url:
              type: string
              format: uri
            next_page_url:
              type:
              - string
              - 'null'
              format: uri
            page:
              type: integer
            page_size:
              type: integer
            previous_page_url:
              type:
              - string
              - 'null'
              format: uri
            url:
              type: string
              format: uri
            key:
              type: string
    CreateFleetRequest:
      type: object
      required:
      - NetworkAccessProfile
      properties:
        NetworkAccessProfile:
          type: string
          description: The SID or unique name of the Network Access Profile that will control which cellular networks the Fleet's SIMs can connect to.
        UniqueName:
          type: string
          description: An application-defined string that uniquely identifies the resource. It can be used in place of the resource's `sid` in the URL to address the resource.
        DataEnabled:
          type: boolean
          description: Defines whether SIMs in the Fleet are capable of using 2G/3G/4G/LTE/CAT-M data connectivity. Defaults to `true`.
        DataLimit:
          type: integer
          description: The total data usage (download and upload combined) in Megabytes that each Super SIM assigned to the Fleet can consume during a billing period (normally one month). Value must be between 1MB (1) and 2TB (2,000,000). Defaults to 1GB (1,000).
        IpCommandsUrl:
          type: string
          format: uri
          description: The URL that will receive a webhook when a Super SIM in the Fleet is used to send an IP Command from your device to a special IP address. Your server should respond with an HTTP status code in the 200 range; any response body will be ignored.
        IpCommandsMethod:
          type: string
          format: http-method
          enum:
          - HEAD
          - GET
          - POST
          - PATCH
          - PUT
          - DELETE
          description: A string representing the HTTP method to use when making a request to `ip_commands_url`. Can be one of `POST` or `GET`. Defaults to `POST`.
        SmsCommandsEnabled:
          type: boolean
          description: Defines whether SIMs in the Fleet are capable of sending and receiving machine-to-machine SMS via Commands. Defaults to `true`.
        SmsCommandsUrl:
          type: string
          format: uri
          description: The URL that will receive a webhook when a Super SIM in the Fleet is used to send an SMS from your device to the SMS Commands number. Your server should respond with an HTTP status code in the 200 range; any response body will be ignored.
        SmsCommandsMethod:
          type: string
          format: http-method
          enum:
          - HEAD
          - GET
          - POST
          - PATCH
          - PUT
          - DELETE
          description: A string representing the HTTP method to use when making a request to `sms_commands_url`. Can be one of `POST` or `GET`. Defaults to `POST`.
    supersim.v1.fleet:
      type: object
      properties:
        account_sid:
          type:
          - string
          - 'null'
          minLength: 34
          maxLength: 34
          pattern: ^AC[0-9a-fA-F]{32}$
          description: The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Fleet resource.
        sid:
          type:
          - string
          - 'null'
          minLength: 34
          maxLength: 34
          pattern: ^HF[0-9a-fA-F]{32}$
          description: The unique string that we created to identify the Fleet resource.
        unique_name:
          type:
          - string
          - 'null'
          description: An application-defined string that uniquely identifies the resource. It can be used in place of the resource's `sid` in the URL to address the resource.
        date_created:
          type:
          - string
          - 'null'
          format: date-time
          description: The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
        date_updated:
          type:
          - string
          - 'null'
          format: date-time
          description: The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
        url:
          type:
          - string
          - 'null'
          format: uri
          description: The absolute URL of the Fleet resource.
        data_enabled:
          type:
          - boolean
          - 'null'
          description: Defines whether SIMs in the Fleet are capable of using 2G/3G/4G/LTE/CAT-M data connectivity. Defaults to `true`.
        data_limit:
          type:
          - integer
          - 'null'
          description: The total data usage (download and upload combined) in Megabytes that each Super SIM assigned to the Fleet can consume during a billing period (normally one month). Value must be between 1MB (1) and 2TB (2,000,000). Defaults to 250MB.
        data_metering:
          type:
          - string
          - 'null'
          $ref: '#/components/schemas/fleet_enum_data_metering'
          description: The model by which a SIMs usage is metered and billed. Defaults to `payg`.
        sms_commands_enabled:
          type:
          - boolean
          - 'null'
          description: Defines whether SIMs in the Fleet are capable of sending and receiving machine-to-machine SMS via Commands. Defaults to `false`.
        sms_commands_url:
          type:
          - string
          - 'null'
          format: uri
          description: The URL that will receive a webhook when a Super SIM in the Fleet is used to send an SMS from your device to the SMS Commands number. Your server should respond with an HTTP status code in the 200 range; any response body will be ignored.
        sms_commands_method:
          type:
          - string
          - 'null'
          format: http-method
          enum:
          - HEAD
          - GET
          - POST
          - PATCH
          - PUT
          - DELETE
          description: A string representing the HTTP method to use when making a request to `sms_commands_url`. Can be one of `POST` or `GET`. Defaults to `POST`.
        network_access_profile_sid:
          type:
          - string
          - 'null'
          minLength: 34
          maxLength: 34
          pattern: ^HA[0-9a-fA-F]{32}$
          description: The SID of the Network Access Profile that controls which cellular networks the Fleet's SIMs can connect to.
        ip_commands_url:
          type:
          - string
          - 'null'
          format: uri
          description: The URL that will receive a webhook when a Super SIM in the Fleet is used to send an IP Command from your device to a special IP address. Your server should respond with an HTTP status code in the 200 range; any response body will be ignored.
        ip_commands_method:
          type:
          - string
          - 'null'
          format: http-method
          enum:
          - HEAD
          - GET
          - POST
          - PATCH
          - PUT
          - DELETE
          description: A string representing the HTTP method to use when making a request to `ip_commands_url`. Can be one of `POST` or `GET`. Defaults to `POST`.
    fleet_enum_data_metering:
      type: string
      enum:
      - payg
    UpdateFleetRequest:
      type: object
      properties:
        UniqueName:
          type: string
          description: An application-defined string that uniquely identifies the resource. It can be used in place of the resource's `sid` in the URL to address the resource.
        NetworkAccessProfile:
          type: string
          description: The SID or unique name of the Network Access Profile that will control which cellular networks the Fleet's SIMs can connect to.
        IpCommandsUrl:
          type: string
          format: uri
          description: The URL that will receive a webhook when a Super SIM in the Fleet is used to send an IP Command from your device to a special IP address. Your server should respond with an HTTP status code in the 200 range; any response body will be ignored.
        IpCommandsMethod:
          type: string
          format: http-method
          enum:
          - HEAD
          - GET
          - POST
          - PATCH
          - PUT
          - DELETE
          description: A string representing the HTTP method to use when making a request to `ip_commands_url`. Can be one of `POST` or `GET`. Defaults to `POST`.
        SmsCommandsUrl:
          type: string
          format: uri
          description: The URL that will receive a webhook when a Super SIM in the Fleet is used to send an SMS from your device to the SMS Commands number. Your server should respond with an HTTP status code in the 200 range; any response body will be ignored.
        SmsCommandsMethod:
          type: string
          format: http-method
          enum:
          - HEAD
          - GET
          - POST
          - PATCH
          - PUT
          - DELETE
          description: A string representing the HTTP method to use when making a request to `sms_commands_url`. Can be one of `POST` or `GET`. Defaults to `POST`.
        DataLimit:
          type: integer
          description: The total data usage (download and upload combined) in Megabytes that each Super SIM assigned to the Fleet can consume during a billing period (normally one month). Value must be between 1MB (1) and 2TB (2,000,000). Defaults to 1GB (1,000).
  securitySchemes:
    accountSid_authToken:
      type: http
      scheme: basic
x-maturity:
- name: GA
  description: This product is Generally Available.
- name: Beta
  description: PLEASE NOTE that this is a Beta product that is subject to change. Use it with caution.
x-provenance:
  method: harvested
  publisher: Twilio
  source: https://raw.githubusercontent.com/twilio/twilio-oai/main/spec/json/twilio_supersim_v1.json
  note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
    stamped by stamp-openapi-provenance.py (roadmap#793)

Twilio Fleets API

Operations 4

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