---
title: "Update conference room"
method: PUT
path: "/api/fabric/resources/conference_rooms/{id}"
tags: ["Conference Rooms"]
---

# Update conference room

`PUT /api/fabric/resources/conference_rooms/{id}`

Updates a Conference Room by ID

#### Permissions

The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.

[Learn more about API scopes](/docs/platform/your-signalwire-api-space).

## Path parameters

- `id` string, uuid, required — Universal Unique Identifier.

## Request body

- ConferenceRoomUpdateRequest
  - `name` string — The name of the Conference Room
  - `display_name` string — Display name of the Conference Room
  - `description` string — The descrption of the Conference Room
  - `join_from` string, date-time — The time users are allowed to start joining the conference. Joining before this time will result in failure to join the conference.
  - `join_until` string, date-time — The time users are allowed to until the conference is locked. Attempting to join the conference after the set time will result in failure to join the conference.
  - `max_members` integer — Maximum number of members allowed in the conference room
  - `quality` '1080p' | '720p' — The viudeo quality of the Conference Room.
  - `remove_at` string, date-time — The time to remove all participants from the conference.
  - `remove_after_seconds_elapsed` integer — The amount of time in seconds to remove a particpant from a conference after they join.
  - `layout` 'grid-responsive' | 'grid-responsive-mobile' | 'highlight-1-responsive' | '1x1' | '2x1' | '2x2' | '5up' | '3x3' | '4x4' | '5x5' | '6x6' | '8x8' | '10x10'
  - `record_on_start` boolean — Starts recording when the conference starts.
  - `enable_room_previews` boolean, required — Enables live video room previews for the conference.
  - `meta` object — Metadata of the conference.
  - `sync_audio_video` boolean, required — Syncs the participants audio and video.
  - `tone_on_entry_and_exit` boolean — Plays a tone when a participant joins or leaves the conference.
  - `room_join_video_off` boolean — Turns the conference video off when the participant joins the room if `true`.
  - `user_join_video_off` boolean — Turns the participants video off when the participant joins the room if `true`.

## Response `200`

The request has succeeded.

- ConferenceRoomResponse
  - `id` string, uuid, required — Universal Unique Identifier.
  - `project_id` string, uuid, required — Universal Unique Identifier.
  - `display_name` string, required — Display name of the Conference Room Fabric Resource
  - `type` 'video_room', required — Type of the Fabric Resource
  - `created_at` string, date-time, required — Date and time when the resource was created.
  - `updated_at` string, date-time, required — Date and time when the resource was updated.
  - `conference_room` ConferenceRoom, required
    - `id` string, uuid, required — Universal Unique Identifier.
    - `name` string, required — The name of the Conference Room
    - `description` string, required — The descrption of the Conference Room
    - `display_name` string, required — Display name of the Conference Room
    - `max_members` integer, required — Maximum number of members allowed in the conference room
    - `quality` '1080p' | '720p', required — The viudeo quality of the Conference Room.
    - `fps` 30 | 20, required — The frames-per-second (fps) of the participants videos in the conference.
    - `join_from` string, date-time, nullable, required — The time users are allowed to start joining the conference. Joining before this time will result in failure to join the conference.
    - `join_until` string, date-time, nullable, required — The time users are allowed to until the conference is locked. Attempting to join the conference after the set time will result in failure to join the conference.
    - `remove_at` string, date-time, nullable, required — The time to remove all participants from the conference.
    - `remove_after_seconds_elapsed` integer, nullable, required — The amount of time in seconds to remove a particpant from a conference after they join.
    - `layout` 'grid-responsive' | 'grid-responsive-mobile' | 'highlight-1-responsive' | '1x1' | '2x1' | '2x2' | '5up' | '3x3' | '4x4' | '5x5' | '6x6' | '8x8' | '10x10', required
    - `record_on_start` boolean, required — Starts recording when the conference starts.
    - `tone_on_entry_and_exit` boolean, required — Plays a tone when a participant joins or leaves the conference.
    - `room_join_video_off` boolean, required — Turns the conference video off when the participant joins the room if `true`.
    - `user_join_video_off` boolean, required — Turns the participants video off when the participant joins the room if `true`.
    - `enable_room_previews` boolean, required — Enables live video room previews for the conference.
    - `sync_audio_video` boolean, nullable, required — Syncs the participants audio and video.
    - `meta` object, required — Metadata of the conference.
    - `prioritize_handraise` boolean, required — Indicator if the Conference Room will prioritize showing participants utilizing the hand raised feature.

## Other responses

- `401` — Access is unauthorized.
- `404` — The server cannot find the requested resource.
- `422` — The request contains invalid parameters. See errors for details.
- `500` — An internal server error occurred.

---

[API](https://skmtc.net/signalwire/apis/signalwire-rest-api.md) · [All operations](https://skmtc.net/signalwire/apis/signalwire-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/signalwire/signalwire-rest-api/versions/05c5164b85c7/schema)