Sign in

v1

latestOpenAPI 3.0.32026-07-174917.3 KB
Rooms

Create a room

Creates a new room with secure defaults for external API usage.

Defaults:

  • Delegated user is set as owner
  • Room slug auto-generated for uniqueness
  • Telephony PIN auto-generated when enabled
  • Creation tracked with application client_id for auditing
post/rooms/

Request body

access_level'public' | 'trusted' | 'restricted'

Controls who can join the room without going through the lobby.

  • public: Anyone with the room link can join directly, no authentication required.
  • trusted: Authenticated users join directly. Unauthenticated users wait in the lobby for approval.
  • restricted: Only participants explicitly trusted by the owner bypass the lobby. Everyone else waits for approval regardless of authentication.

Example request

{
  "access_level": "trusted",
  "configuration": {
    "can_publish_sources": [
      "camera",
      "microphone"
    ],
    "everyone_can_mute": true
  }
}

Response

Room created successfully

idstring uuid

Unique room identifier

slugstring

URL-friendly room identifier (auto-generated)

access_level'public' | 'trusted' | 'restricted'

Controls who can join the room without going through the lobby.

  • public: Anyone with the room link can join directly, no authentication required.
  • trusted: Authenticated users join directly. Unauthenticated users wait in the lobby for approval.
  • restricted: Only participants explicitly trusted by the owner bypass the lobby. Everyone else waits for approval regardless of authentication.
urlstring uri

Full URL to access the room

Example response

{
  "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "slug": "aze-eere-zer",
  "access_level": "trusted",
  "url": "https://visio-sandbox.beta.numerique.gouv.fr/aze-eere-zer",
  "telephony": {
    "enabled": true,
    "pin_code": "123456",
    "phone_number": "+1-555-0100",
    "default_country": "US"
  },
  "configuration": {
    "can_publish_sources": [
      "camera",
      "microphone"
    ],
    "everyone_can_mute": true
  }
}