Get video conference

curl https://{your_space_name}.signalwire.com/api/video/conferences/id \
     -u "<project_id>:<api_token>"

{
  "id": "c22d24f6-5a47-4597-9a23-c7d01e696b92",
  "name": "my_conference",
  "display_name": "My Conference's Name",
  "description": "This conference will be used for full company all hands meetings",
  "join_from": "2022-01-01T00:00:00Z",
  "join_until": "2022-12-31T23:59:59Z",
  "quality": "720p",
  "layout": "grid-responsive",
  "size": "medium",
  "record_on_start": false,
  "tone_on_entry_and_exit": true,
  "user_join_video_off": false,
  "room_join_video_off": false,
  "enable_chat": true,
  "enable_room_previews": false,
  "dark_primary": "#044EF4",
  "dark_background": "#FFFFFF",
  "dark_foreground": "#1D2127",
  "dark_success": "#17BB58",
  "dark_negative": "#F42C50",
  "light_primary": "#044EF4",
  "light_background": "#FFFFFF",
  "light_foreground": "#1D2127",
  "light_success": "#17BB58",
  "light_negative": "#F42C50",
  "meta": {},
  "created_at": "2022-01-01T10:00:00Z",
  "updated_at": "2022-01-01T11:00:00Z",
  "active_session": {
    "id": "c22d24f6-5a47-4597-9a23-c7d01e696b92",
    "room_id": "a1b2c3d4-5e6f-7890-abcd-ef1234567890",
    "name": "my_example_room",
    "display_name": "My Room's Name",
    "join_from": "2022-01-01T00:00:00Z",
    "join_until": "2022-12-31T23:59:59Z",
    "remove_at": "2022-12-31T23:59:59Z",
    "remove_after_seconds_elapsed": 120,
    "layout": "grid-responsive",
    "max_members": 20,
    "fps": 20,
    "quality": "720p",
    "start_time": "2022-01-01T10:00:00Z",
    "end_time": "2022-01-01T11:00:00Z",
    "duration": 120,
    "status": "completed",
    "record_on_start": true,
    "enable_room_previews": true,
    "preview_url": "https://example.signalwire.com/api/video/room_sessions/c22d24f6-5a47-4597-9a23-c7d01e696b92/preview",
    "audio_video_sync": true
  }
}

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

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

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error

422

Unprocessable Entity Error

500

Internal Server Error

Authorization: Basic base64(project_id:token)