Skip to contentSkip to navigationSkip to topbar
On this page

Programmable Video REST API


(warning)

Warning

This documentation is for reference only. We are no longer onboarding new customers to Programmable Video. Existing customers can continue to use the product until December 5, 2026(link takes you to an external page).

We recommend migrating your application to the API provided by our preferred video partner, Zoom. We've prepared this migration guide(link takes you to an external page) to assist you in minimizing any service disruption.

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.

1
https://video.twilio.com
2

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


Authentication

authentication page anchor

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.

1
curl -G https://video.twilio.com/v1/Rooms \
2
-u '{API Key Sid}:{API Key Secret}'
3

You can manage your API Keys in the console(link takes you to an external page).


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

ResourceDescription
RoomsA 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.
ParticipantsA Participant is one user session in a Room.
PublishedTrackPublished Tracks represent media shared in a Room by a Participant.
Track SubscriptionsSubscribe Rules represent Participant's Track Subscriptions.
RecordingsA Recording represents the recorded media for an audio, video, or screen share Track shared in a Room.
CompositionsA Composition represents a playable media file resulting from the mixing of a set of Group Room video Recordings.

Need some help?

Terms of service

Copyright © 2024 Twilio Inc.