Skip to main content

Create a Video Conference

Create a Video Conference.

Permissions

The API token must include the following scopes: Video.

Request Body REQUIRED
name string

A named unique identifier for the room. Allowed characters: A-Za-z0-9_-. Maximum of 100 characters.

display_name string

Display name of the video conference. Maximum of 200 characters. Defaults to the value of name.

description string

Description of the room. Maximum of 3000 characters.

join_from date-time

Conference does not accept new participants before this time. Expects RFC 3339 datetime: 2022-01-01T23:59:60Z. Date only: 2022-01-01 will be converted to 2022-01-01T00:00:00Z

join_until date-time

Conference stops accepting new participants at this time, but keeps running until all participants leave. Expects RFC 3339 datetime: 2022-01-01T23:59:60Z. Date only: 2022-01-01 will be converted to 2022-01-01T00:00:00Z

quality string

The conference's resolution. Allowed values are 720p or 1080p. Defaults to 720p.

layout string

The conference's initial layout. Defaults to grid-responsive. See documentation for a full list of supported layouts.

size string

The size of the video conference. Allowed values are small, medium and large. Defaults to medium. See documentation for a list of size limitations.

record_on_start boolean

Specifies whether to start recording a Conference Session when one is started for this Conference

enable_room_previews boolean

Whether a video with a preview of the content of the conference is to be generated.

enable_chat boolean

Enables group chat for all participants of the room. Defaults to true.

dark_primary string

Used for CTA buttons and selected items. Defaults to #044EF4

dark_background string

Main background color. Defaults to #FFFFFF

dark_foreground string

Main foreground color. Defaults to #1D2127

dark_success string

Used for success indications. Defaults to #17BB58

dark_negative string

Used for error indications. Defaults to #F42C50

light_primary string

Used for CTA buttons and selected items. Defaults to #044EF4

light_background string

Main background color. Defaults to #FFFFFF

light_foreground string

Main foreground color. Defaults to #1D2127

light_success string

Used for success indications. Defaults to #17BB58

light_negative string

Used for error indications. Defaults to #F42C50

Responses
200

OK

Schema OPTIONAL
id uuid OPTIONAL

A unique identifier for the video conference

name string OPTIONAL

A named unique identifier for the room. Allowed characters: A-Za-z0-9_-. Maximum of 100 characters.

display_name string OPTIONAL

Display name of the video conference. Maximum of 200 characters. Defaults to the value of name.

description string OPTIONAL

Description of the room. Maximum of 3000 characters.

join_from date-time OPTIONAL

Conference does not accept new participants before this time. Expects RFC 3339 datetime: 2022-01-01T23:59:60Z. Date only: 2022-01-01 will be converted to 2022-01-01T00:00:00Z

join_until date-time OPTIONAL

Conference stops accepting new participants at this time, but keeps running until all participants leave. Expects RFC 3339 datetime: 2022-01-01T23:59:60Z. Date only: 2022-01-01 will be converted to 2022-01-01T00:00:00Z

quality string OPTIONAL

The conference's resolution. Allowed values are 720p or 1080p. Defaults to 720p.

layout string OPTIONAL

The conference's initial layout. Defaults to grid-responsive. See documentation for a full list of supported layouts.

size string OPTIONAL

The size of the video conference. Allowed values are small, medium and large. Defaults to medium. See documentation for a list of size limitations.

record_on_start boolean OPTIONAL

Specifies whether to start recording a Conference Session when one is started for this Conference

enable_room_previews boolean OPTIONAL

Whether a video with a preview of the content of the conference is to be generated.

enable_chat boolean OPTIONAL

Enables group chat for all participants of the room. Defaults to true.

dark_primary string OPTIONAL

Used for CTA buttons and selected items. Defaults to #044EF4

dark_background string OPTIONAL

Main background color. Defaults to #FFFFFF

dark_foreground string OPTIONAL

Main foreground color. Defaults to #1D2127

dark_success string OPTIONAL

Used for success indications. Defaults to #17BB58

dark_negative string OPTIONAL

Used for error indications. Defaults to #F42C50

light_primary string OPTIONAL

Used for CTA buttons and selected items. Defaults to #044EF4

light_background string OPTIONAL

Main background color. Defaults to #FFFFFF

light_foreground string OPTIONAL

Main foreground color. Defaults to #1D2127

light_success string OPTIONAL

Used for success indications. Defaults to #17BB58

light_negative string OPTIONAL

Used for error indications. Defaults to #F42C50

created_at date-time OPTIONAL
updated_at date-time OPTIONAL
active_session object OPTIONAL
id uuid OPTIONAL

Unique ID of the session

room_id uuid OPTIONAL

Unique ID of the Room if the Session was created from a Room and was not an auto-created Session.

name string OPTIONAL

The named identifier of room session.

display_name string OPTIONAL

Display name of room, no character limitations. Maxium of 200 characters. Defaults to the value of name.

join_from date-time OPTIONAL

Room Session does not accept new Members before this time.

join_until date-time OPTIONAL

Room Session stops accepting new Members at this time.

remove_at date-time OPTIONAL

Remove Members from the Room Session at this time.

remove_after_seconds_elapsed int32 OPTIONAL

Remove Members after they are in the Room Session for N seconds.

layout string OPTIONAL

The Room Session's initial layout. Defaults to grid-responsive. See documentation for a full list of supported layouts.

max_members integer OPTIONAL

The maximum number of members allowed in the room at a time.

fps integer OPTIONAL

The Room Session's frames per second. Possible values are 20 or 30.

quality string OPTIONAL

The Room Session's resolution. Possible values are 720p or 1080p.

start_time date-time OPTIONAL
end_time date-time OPTIONAL
duration integer OPTIONAL

How long, in seconds, the Room Session lasted.

status string OPTIONAL
record_on_start boolean OPTIONAL

Whether a recording was automatically started when this Room Session began.

enable_room_previews boolean OPTIONAL

Whether a video with a preview of the content of the room is to be generated.

preview_url string OPTIONAL

If room previews are enabled and the room session is in progress, this is the URL of the preview video.

audio_video_sync boolean OPTIONAL

Enable/disable jitter buffer audio-video sync.