Twilio OpenAPI Specification

repository·main·Indexed 41 days ago

https://github.com/twilio/twilio-oai

Official OpenAPI Specification (OAS) documents for Twilio's APIs, providing standardized JSON and YAML interfaces for programmatic discovery and interaction. Version 2.x.x introduces support for PUT HTTP methods and application/json request bodies.

Tokens
273
Snippets
0
Records
3
Agent score
3%

What's inside Twilio

  1. Access Twilio's OpenAPI Specification files

    main

    Twilio's API capabilities are defined using the OpenAPI Specification (OAS). You can find the machine-readable interface documents in the following directories within this repository:

    • json/: Contains the specification in JSON format.
    • yaml/: Contains the specification in YAML format.

    These files allow developers and tools to discover and interact with Twilio's HTTP APIs with minimal implementation logic and without needing to inspect network traffic or source code.

  2. Upgrade from 1.56.x to 2.x.x

    main

    When upgrading from version 1.56.x to 2.x.x (released 2024-06-18), note the following new capabilities added to the OpenAPI specification:

    • PUT Method Support: The specification now includes support for PUT HTTP methods.
    • JSON Request Bodies: The specification now supports the application/json content type for request bodies.
  3. Report mismatches between the specification and Twilio API behavior

    main
    The project is in GA (General Availability) and is under active development. If you encounter a discrepancy where the Twilio API behaves differently than what is described in the OpenAPI specification, please open an issue on GitHub to report the mismatch.