Create scheduled video room

Schedules a video meeting room for a future start. Project defaults and video-specific locks apply; metadata.default_lock_settings does not override them. Providing external_user_id and name binds the creator. Returns room_id and start_time, plus participant_id for an identity-bound creator; no final_link is issued until the room starts. Invalid settings, duplicate client_room_id, and project/key mismatches are rejected.

Authorization

key<token>

In: header

hash-signature<token>

Base64-encoded HMAC-SHA256 of the resolved request body, signed with the project secret (not the API key).

In: header

Request Body

project_idstring

start_atstring

Future YYYY-MM-DDTHH:MM in the agreed server scheduling timezone; no timezone suffix.

name?string

Required when external_user_id is supplied.

external_user_id?string

Optional stable creator ID; cannot first be assigned at start.

Lengthlength <= 255

logout_url?string

Optional top-level HTTP(S) room logout override; otherwise project default.

Lengthlength <= 255

webhook_url?string

client_room_id?string

max_participantsstring|integer

empty_timeoutstring|integer

metadata

Response Body

application/json

curl -X POST "https://api.qriib.dev/api/v4/rooms/create_schedule_video_room" \  -H "Content-Type: application/json" \  -d '{    "type": "object",    "required": [      "project_id",      "start_at",      "max_participants",      "empty_timeout",      "metadata"    ],    "properties": {      "project_id": {        "type": "string"      },      "start_at": {        "type": "string",        "description": "Future YYYY-MM-DDTHH:MM in the agreed server scheduling timezone; no timezone suffix."      },      "name": {        "type": "string",        "description": "Required when external_user_id is supplied."      },      "external_user_id": {        "type": "string",        "maxLength": 255,        "description": "Optional stable creator ID; cannot first be assigned at start."      },      "logout_url": {        "type": "string",        "maxLength": 255,        "description": "Optional top-level HTTP(S) room logout override; otherwise project default."      },      "webhook_url": {        "type": "string"      },      "client_room_id": {        "type": "string"      },      "max_participants": {        "oneOf": [          {            "type": "string"          },          {            "type": "integer"          }        ]      },      "empty_timeout": {        "oneOf": [          {            "type": "string"          },          {            "type": "integer"          }        ]      },      "metadata": {        "type": "object",        "required": [          "room_title",          "welcome_message"        ],        "properties": {          "room_title": {            "type": "string",            "description": "Mandatory main title of the room displayed to participants"          },          "welcome_message": {            "type": "string"          },          "room_features": {            "type": "object",            "description": "Only room_duration and breakout_room_features.allowed_number_rooms are read as room-level requests; other features come from project settings and plan policy. metadata.default_lock_settings does not override project defaults.",            "properties": {              "room_duration": {                "type": "integer"              },              "breakout_room_features": {                "type": "object",                "properties": {                  "allowed_number_rooms": {                    "type": "integer"                  }                }              }            }          }        }      }    },    "examples": [      {        "project_id": "{{projectId}}",        "start_at": "2027-01-20T14:00",        "name": "Amina Hassan",        "external_user_id": "employee-8271",        "client_room_id": "dasxzcxc",        "max_participants": "20",        "empty_timeout": "300",        "metadata": {          "room_title": "Test room",          "welcome_message": "Welcome to room",          "room_features": {            "room_duration": 60          }        }      }    ]  }'

{
  "status": true,
  "room_id": "room-123",
  "participant_id": "opaque-creator-id",
  "start_time": "2027-01-20T14:00:00",
  "room_type": "Video-Room"
}

{
  "error": "Invalid signature"
}

curl -X POST "https://api.qriib.dev/api/v4/rooms/create_schedule_video_room" \ -H "Content-Type: application/json" \ -d '{ "type": "object", "required": [ "project_id", "start_at", "max_participants", "empty_timeout", "metadata" ], "properties": { "project_id": { "type": "string" }, "start_at": { "type": "string", "description": "Future YYYY-MM-DDTHH:MM in the agreed server scheduling timezone; no timezone suffix." }, "name": { "type": "string", "description": "Required when external_user_id is supplied." }, "external_user_id": { "type": "string", "maxLength": 255, "description": "Optional stable creator ID; cannot first be assigned at start." }, "logout_url": { "type": "string", "maxLength": 255, "description": "Optional top-level HTTP(S) room logout override; otherwise project default." }, "webhook_url": { "type": "string" }, "client_room_id": { "type": "string" }, "max_participants": { "oneOf": [ { "type": "string" }, { "type": "integer" } ] }, "empty_timeout": { "oneOf": [ { "type": "string" }, { "type": "integer" } ] }, "metadata": { "type": "object", "required": [ "room_title", "welcome_message" ], "properties": { "room_title": { "type": "string", "description": "Mandatory main title of the room displayed to participants" }, "welcome_message": { "type": "string" }, "room_features": { "type": "object", "description": "Only room_duration and breakout_room_features.allowed_number_rooms are read as room-level requests; other features come from project settings and plan policy. metadata.default_lock_settings does not override project defaults.", "properties": { "room_duration": { "type": "integer" }, "breakout_room_features": { "type": "object", "properties": { "allowed_number_rooms": { "type": "integer" } } } } } } } }, "examples": [ { "project_id": "{{projectId}}", "start_at": "2027-01-20T14:00", "name": "Amina Hassan", "external_user_id": "employee-8271", "client_room_id": "dasxzcxc", "max_participants": "20", "empty_timeout": "300", "metadata": { "room_title": "Test room", "welcome_message": "Welcome to room", "room_features": { "room_duration": 60 } } } ] }'

Create scheduled video room

Authorization

Request Body

Response Body

201application/json

401application/json

Authorization

Request Body

Response Body

201application/json

401application/json

application/json

application/json

application/json

application/json