VideoConferences

Find a Video Conference by ID

View as Markdown

Find a Video Conference by ID.

Permissions

The API token used to authenticate must have the following scope(s) enabled to make a successful request: Video.

Learn more about API scopes.

Authentication

AuthorizationBasic
SignalWire Basic Authentication using Project ID and API Token. The client sends HTTP requests with the Authorization header containing the word Basic followed by a space and a base64-encoded string of project_id:token. The project ID will be used as the username and the API token as the password. Example: ``` Authorization: Basic base64(project_id:token) ```

Path parameters

idstringRequiredformat: "uuid"
Unique ID of the video conference.

Query parameters

include_active_sessionbooleanOptional

Specifies whether to include information about the conference’s active session (if any).

Response

Conference response wrapper.
idstringformat: "uuid"
Unique ID of the video conference.
namestring

A named unique identifier for the conference. Allowed characters: A-Za-z0-9_-.

display_namestring or null
Display name of the video conference. Maximum of 200 characters.
descriptionstring or null
Description of the conference. Maximum of 3000 characters.
join_fromdatetime or null
Conference does not accept new participants before this time.
join_untildatetime or null
Conference stops accepting new participants at this time, but keeps running until all participants leave.
qualityenum
The conference's resolution.
Allowed values:
layoutenum
The conference's initial layout.
sizeenum or null
The size of the video conference.
Allowed values:
record_on_startboolean
Whether to start recording when a conference session begins.
tone_on_entry_and_exitboolean
Whether a tone is played when a member enters or exits the conference.
user_join_video_offboolean
Whether participants join with video off by user setting.
room_join_video_offboolean
Whether participants join with video off by room setting.
enable_chatboolean
Whether group chat is enabled for conference participants.
enable_room_previewsboolean or null
Whether a preview video of the conference content is generated.
dark_primarystring or null

CTA buttons and selected items color (dark theme).

dark_backgroundstring or null

Main background color (dark theme).

dark_foregroundstring or null

Main foreground color (dark theme).

dark_successstring or null

Success indication color (dark theme).

dark_negativestring or null

Error indication color (dark theme).

light_primarystring or null

CTA buttons and selected items color (light theme).

light_backgroundstring or null

Main background color (light theme).

light_foregroundstring or null

Main foreground color (light theme).

light_successstring or null

Success indication color (light theme).

light_negativestring or null

Error indication color (light theme).

metaobject or null

User-defined metadata for the conference.

created_atdatetime
Timestamp when the conference was created.
updated_atdatetime
Timestamp when the conference was last updated.
active_sessionobject or null

Active session information. Only present when requested via the include_active_session query parameter.

Errors