Update video conference

curl -X PUT https://{your_space_name}.signalwire.com/api/video/conferences/id \
     -H "Content-Type: application/json" \
     -u "<project_id>:<api_token>" \
     -d '{
  "display_name": "My Conference'\''s Name"
}'

{
  "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
  }
}

Changes how a managed Video Conference is presented and runs for subsequent joins while preserving the same project resource and access links.

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.

Request

This endpoint expects an object.

display_namestringRequired<=200 characters

Display name of the video conference. Maximum of 200 characters.

descriptionstringOptional<=3000 characters

Description of the conference. Maximum of 3000 characters.

join_fromdatetimeOptional

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_untildatetimeOptional

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.

qualityenumOptionalDefaults to 720p

The conference's resolution.

Allowed values:

layoutenumOptionalDefaults to grid-responsive

The conference's initial layout.

sizeenumOptionalDefaults to medium

The size of the video conference.

Allowed values:

record_on_startbooleanOptional

Whether to start recording when a conference session begins.

tone_on_entry_and_exitbooleanOptional

Whether a tone is played when a member enters or exits the conference.

room_join_video_offbooleanOptional

Whether participants join with video off by room setting.

user_join_video_offbooleanOptional

Whether participants join with video off by user setting.

enable_room_previewsbooleanOptional

Whether a preview video of the conference content is generated.

enable_chatbooleanOptional

Whether group chat is enabled for conference participants.

dark_primarystringOptionalformat: "^#[0-9a-fA-F]{6}$"

CTA buttons and selected items color (dark theme).

dark_backgroundstringOptionalformat: "^#[0-9a-fA-F]{6}$"

Main background color (dark theme).

dark_foregroundstringOptionalformat: "^#[0-9a-fA-F]{6}$"

Main foreground color (dark theme).

dark_successstringOptionalformat: "^#[0-9a-fA-F]{6}$"

Success indication color (dark theme).

dark_negativestringOptionalformat: "^#[0-9a-fA-F]{6}$"

Error indication color (dark theme).

light_primarystringOptionalformat: "^#[0-9a-fA-F]{6}$"

CTA buttons and selected items color (light theme).

light_backgroundstringOptionalformat: "^#[0-9a-fA-F]{6}$"

Main background color (light theme).

light_foregroundstringOptionalformat: "^#[0-9a-fA-F]{6}$"

Main foreground color (light theme).

light_successstringOptionalformat: "^#[0-9a-fA-F]{6}$"

Success indication color (light theme).

light_negativestringOptionalformat: "^#[0-9a-fA-F]{6}$"

Error indication color (light theme).

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_sessionobjectOptional

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