---
title: "Create a user-specific temporary room"
method: POST
path: "/api/rooms"
tags: ["API"]
---

# Create a user-specific temporary room

`POST /api/rooms`

## Request body

- RoomConfig
  - `meetingId` string, required
  - `roomId` string
  - `group` string
  - `name` string, required
  - `subtitle` string
  - `description` string
  - `joinUrl` string
  - `temporary` boolean
  - `links` Link[]
    - `href` string, required
    - `text` string, required
    - `icon` string
  - `icon` string

## Response `204`

Success

## Other responses

- `405` — Room creation requires a valid user
- `409` — Room with same id already exists
- `500` — Internal error

## Changes

- **2026-07-17** `5cc6ee797979` — 2 info
  - added the new optional request property `description`
  - added the new optional request property `subtitle`
- **2020-05-15** `4f956108d8ee` — 1 breaking, 1 warning, 1 info
  - added the new required request property `meetingId`
  - removed the request property `id`
  - added the new optional request property `roomId`
- **2020-04-09** `2b3d3fd9542a` — 2 breaking, 2 warning, 5 info
  - added the new required request property `id`
  - added the new required request property `name`
  - removed `#/components/schemas/roomCreation` from the request body `allOf` list
  - removed the request property `participants`
  - …5 more
- **2020-04-09** `210ce6fde311` — 1 info
  - the request property `allOf[#/components/schemas/roomCreation]/joinUrl` became optional
- **2020-04-09** `a6f81e89767a` — 1 warning
  - removed the request property `allOf[#/components/schemas/roomCreation]/participants`

[Full history](https://skmtc.dev/tng/apis/virtual-office/changes/api/rooms/post.md)

---

[API](https://skmtc.dev/tng/apis/virtual-office.md) · [All operations](https://skmtc.dev/tng/apis/virtual-office/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/tng/virtual-office/revisions/5cc6ee797979/schema)