Get conference room

GET

https://{your_space_name}.signalwire.com/api/fabric/resources/conference_rooms/:id

GET

/api/fabric/resources/conference_rooms/:id

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

{
  "id": "993ed018-9e79-4e50-b97b-984bd5534095",
  "project_id": "1313fe58-5e14-4c11-bbe7-6fdfa11fe780",
  "display_name": "Reception",
  "type": "video_room",
  "created_at": "2024-05-06T12:20:00Z",
  "updated_at": "2024-05-06T12:20:00Z",
  "conference_room": {
    "id": "1bd571e4-5ea4-4a70-a3c8-2bab5d20e754",
    "name": "coffee_cafe",
    "description": "This room is for coffee, no shop talk",
    "display_name": "Reception",
    "max_members": 30,
    "quality": "1080p",
    "fps": 30,
    "join_from": "2024-05-06T12:20:00Z",
    "join_until": "2024-05-06T12:20:00Z",
    "remove_at": "2024-05-06T12:20:00Z",
    "remove_after_seconds_elapsed": 1,
    "layout": "grid-responsive",
    "record_on_start": true,
    "tone_on_entry_and_exit": true,
    "room_join_video_off": true,
    "user_join_video_off": true,
    "enable_room_previews": true,
    "sync_audio_video": true,
    "meta": {
      "foo": "bar"
    },
    "prioritize_handraise": false
  }
}

Retrieves one Fabric Conference Room by resource ID so you can inspect how the addressable room is configured. Use List conference rooms to discover IDs, or Get video conference for a managed hosted conference.

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.

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 a Conference Room.

Response

The request has succeeded.

idstringformat: "uuid"

Unique ID of the Conference Room.

project_idstringformat: "uuid"

Unique ID of the Project.

display_namestring

Display name of the Conference Room Fabric Resource

typeenum

Type of the Fabric Resource

Allowed values:

created_atdatetime

Date and time when the resource was created.

updated_atdatetime

Date and time when the resource was updated.

conference_roomobject

Conference Room data.

Errors

401

Unauthorized Error

404

Not Found Error

500

Internal Server Error