Skip to contentSkip to navigationSkip to topbar
On this page

Configure the Maximum Participant Duration for a Room


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

Twilio Video Rooms allow you to configure the maximum amount of time that a Participant can be connected to the Room. The default maximum Participant duration for Video Rooms is four hours and the maximum amount of time a Participant can be connected to a Room is 24 hours. Once a Participant has been connected to a Room for the Room's maximum Participant duration, they will be disconnected from the Room.

If you wish to configure the maximum Participant duration for you Video Rooms, you can do so in two ways: via the Twilio REST API, or via the Twilio Console.


REST API

rest-api page anchor

You can configure the maximum Participant duration for Video Rooms on a per-Room basis during Room creation using the REST API. When creating the Room, you can specify the maximum Participant duration in seconds.

Configure a Room's maximum Participant durationLink to code sample: Configure a Room's maximum Participant duration
1
// Download the helper library from https://www.twilio.com/docs/node/install
2
const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio";
3
4
// Find your Account SID and Auth Token at twilio.com/console
5
// and set the environment variables. See http://twil.io/secure
6
const accountSid = process.env.TWILIO_ACCOUNT_SID;
7
const authToken = process.env.TWILIO_AUTH_TOKEN;
8
const client = twilio(accountSid, authToken);
9
10
async function createRoom() {
11
const room = await client.video.v1.rooms.create({
12
maxParticipantDuration: 86400,
13
uniqueName: "My Video Room",
14
});
15
16
console.log(room.sid);
17
}
18
19
createRoom();

Output

1
{
2
"account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
3
"date_created": "2015-07-30T20:00:00Z",
4
"date_updated": "2015-07-30T20:00:00Z",
5
"status": "in-progress",
6
"type": "peer-to-peer",
7
"sid": "RMaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
8
"enable_turn": true,
9
"unique_name": "My Video Room",
10
"max_concurrent_published_tracks": 0,
11
"max_participants": 10,
12
"max_participant_duration": 86400,
13
"duration": 0,
14
"status_callback_method": "POST",
15
"status_callback": null,
16
"record_participants_on_connect": false,
17
"video_codecs": [
18
"VP8"
19
],
20
"media_region": "us1",
21
"audio_only": false,
22
"empty_room_timeout": 5,
23
"unused_room_timeout": 5,
24
"end_time": "2015-07-30T20:00:00Z",
25
"large_room": false,
26
"url": "https://video.twilio.com/v1/Rooms/RMaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
27
"links": {
28
"participants": "https://video.twilio.com/v1/Rooms/RMaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Participants",
29
"recordings": "https://video.twilio.com/v1/Rooms/RMaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Recordings",
30
"recording_rules": "https://video.twilio.com/v1/Rooms/RMaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/RecordingRules"
31
}
32
}

In the Twilio Console, you can update the default maximum Participant duration for all of the Video Rooms created in your account. After you update this value in the Console, any new Rooms that you create without explicitly setting the maximum Participant duration will take this configured value.

To update this value, navigate to Room Settings(link takes you to an external page) section in the Console, where you will be able to update the value. Note that the duration should be specified in seconds.

By default, PSTN Participants are limited to a four-hour maximum duration. You can enable the 24-hour maximum duration in your Programmable Voice Settings console.(link takes you to an external page)

Need some help?

Terms of service

Copyright © 2024 Twilio Inc.