Sign in
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
  }
}

Changes

Changed in 3 of the 8 revisions of this API.236

  • 617971cb202f34See the full diff
    • ●

      added the new public enum value to the response property for the response status

      response-property-enum-value-added

    • ●

      added the new restricted enum value to the response property for the response status

      response-property-enum-value-added

    • ●

      added the new trusted enum value to the response property for the response status

      response-property-enum-value-added

    • ○

      added the new optional request property

      new-optional-request-property

    • ○

      added the new optional request property

      new-optional-request-property

    • ○

      added the optional property to the response with the status

      response-optional-property-added

    • ○

      the response optional property became not read-only for the status

      response-optional-property-became-not-read-only

  • a85a00b46a4e11See the full diff
    • ▲

      api removed without deprecation

      api-removed-without-deprecation

    • ○

      endpoint added

      endpoint-added

  • 1f775f325b8d11See the full diff
    • ▲

      api path removed without deprecation

      api-path-removed-without-deprecation

    • ○

      endpoint added

      endpoint-added

    This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog