---
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

- RoomCreation
  - `id` string, required
  - `group` string
  - `name` string, required
  - `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

- **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`
- **2020-04-09** `cff00c6f8fb2` — 2 breaking, 7 warning, 1 info
  - added `#/components/schemas/roomCreation` to the request body `allOf` list
  - the request's body type changed from no type to `object`
  - removed the request property `group`
  - removed the request property `icon`
  - …6 more
- **2020-04-03** `174408ac9ef1` — 1 info
  - the request property `temporary` became optional

[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/bd22bb480374/schema)