Rate this page:

Programmable Video REST API

The Programmable Video REST API allows you to control your video applications from your back-end server via HTTP requests. You can create and complete Rooms, query their status, retrieve Recording files, configure a webhook for Status Callbacks, and more.

All Programmable Video REST API resources use the following base URL.

All requests to the Programmable Video Rooms REST API are served over HTTPS. Unencrypted HTTP is not supported.


HTTP requests to the REST API are protected with HTTP Basic authentication. To learn more about how Twilio handles authentication, please refer to our security documentation. You will use your Twilio API Key Sid as the username and the key's associated API Key Secret as the password for HTTP Basic authentication.

curl -G \
       -u '{API Key Sid}:{API Key Secret}'

You can manage your API Keys in the console.


The resources you will be interacting with via the Programmable Video REST API are:

Resource Description
Rooms A Room represents a multi-party communications session among users in your application, where users can share and receive real-time audio and video tracks with one another.
Participants A Participant is one user session in a Room.
PublishedTrack Published Tracks represent media shared in a Room by a Participant.
Recordings A Recording represents the recorded media for an audio, video, or screen share Track shared in a Room.
Compositions A Composition represents a playable media file resulting from the mixing of a set of Group Room video Recordings.
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 Community Forums or browsing the Twilio tag on Stack Overflow.


        Thank you for your feedback!

        We are always striving to improve our documentation quality, and your feedback is valuable to us. How could this documentation serve you better?

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

        Thanks for your feedback!

        Refer us and get $10 in 3 simple steps!

        Step 1

        Get link

        Get a free personal referral link here

        Step 2

        Give $10

        Your user signs up and upgrade using link

        Step 3

        Get $10

        1,250 free SMSes
        OR 1,000 free voice mins
        OR 12,000 chats
        OR more