---
title: "Changes to Create a room with a user, a group or a circle"
method: POST
path: "/ocs/v2.php/apps/spreed/api/{apiVersion}/room"
---

# Changes to Create a room with a user, a group or a circle

`POST /ocs/v2.php/apps/spreed/api/{apiVersion}/room`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 22 of 99 revisions.

- **2026-07-30** `a2b2faeb5c3f`: 3 warning
- **2026-07-27** `53e9f9caf40b`: 1 warning, 2 info
- **2026-07-27** `0ce0facd31e9`: 2 warning, 1 info
- **2026-07-03** `6445cccf6c1b`: 1 warning, 2 info
- **2026-06-25** `018858441ae8`: 1 breaking, 3 warning, 3 info
- **2026-05-06** `2b5840d4b265`: 3 warning
- **2026-04-29** `7e78681bf716`: 3 info
- **2026-03-31** `dc2b6567a07b`: 12 info
- **2026-03-05** `99bd41590ecb`: 3 info
- **2026-02-19** `0a08ea002cd5`: 1 info
- **2026-02-09** `2dd98af77e49`: 6 info
- **2026-01-30** `fb0a9a295f3a`: 1 info
- **2025-12-19** `e33f2a9ba885`: 3 breaking
- **2025-12-13** `836100158f59`: 9 info
- **2025-12-09** `6ef64fbefde3`: 3 info
- **2025-11-04** `7dcb597c730d`: 3 info
- **2025-11-04** `9f3989c87ab7`: 9 info
- **2025-09-02** `7551dadee4c3`: 6 info
- **2025-08-30** `3e9d3577cce9`: 1 info
- **2025-08-29** `eff986f901a2`: 3 info
- **2025-08-29** `188ccf695897`: 3 breaking
- **2025-08-29** `3bdce93d13d5`: 3 info

## Changes

- **2026-07-30** `a2b2faeb5c3f`: 3 warning
  - added the new `classified` enum value to the `ocs/data/error` response property for the response status `400`
  - added the new `classified` enum value to the `ocs/data/error` response property for the response status `403`
  - added the new `classified` enum value to the `ocs/data/error` response property for the response status `404`
- **2026-07-27** `53e9f9caf40b`: 1 warning, 2 info
  - deleted the `header` request parameter `x-nextcloud-talk-external-service`
  - added the new optional `header` request parameter `x-nextcloud-talk-external-service-checksum`
  - added the new optional `header` request parameter `x-nextcloud-talk-external-service-random`
- **2026-07-27** `0ce0facd31e9`: 2 warning, 1 info
  - deleted the `header` request parameter `x-nextcloud-talk-external-service-checksum`
  - deleted the `header` request parameter `x-nextcloud-talk-external-service-random`
  - added the new optional `header` request parameter `x-nextcloud-talk-external-service`
- **2026-07-03** `6445cccf6c1b`: 1 warning, 2 info
  - deleted the `header` request parameter `x-nextcloud-talk-external-service`
  - added the new optional `header` request parameter `x-nextcloud-talk-external-service-checksum`
  - added the new optional `header` request parameter `x-nextcloud-talk-external-service-random`
- **2026-06-25** `018858441ae8`: 1 breaking, 3 warning, 3 info
  - the `ocs/data` response's property type changed from no type to `object` for status `401`
  - added the new `owner` enum value to the `ocs/data/error` response property for the response status `400`
  - added the new `owner` enum value to the `ocs/data/error` response property for the response status `403`
  - added the new `owner` enum value to the `ocs/data/error` response property for the response status `404`
  - added the new optional `header` request parameter `x-nextcloud-talk-external-service`
  - added the new optional request property `owner`
  - added the required property `ocs/data/error` to the response with the `401` status
- **2026-05-06** `2b5840d4b265`: 3 warning
  - added the new `preset` enum value to the `ocs/data/error` response property for the response status `400`
  - added the new `preset` enum value to the `ocs/data/error` response property for the response status `403`
  - added the new `preset` enum value to the `ocs/data/error` response property for the response status `404`
- **2026-04-29** `7e78681bf716`: 3 info
  - added the required property `ocs/data/allOf[#/components/schemas/Room]/tagIds` to the response with the `202` status
  - added the required property `ocs/data/tagIds` to the response with the `200` status
  - added the required property `ocs/data/tagIds` to the response with the `201` status
- **2026-03-31** `dc2b6567a07b`: 12 info
  - added the optional property `ocs/data/allOf[#/components/schemas/Room]/lastMessage/anyOf[#/components/schemas/ChatMessage]/allOf[subschema #2]/metaData/replyToActorDisplayName` to the response with the `202` status
  - added the optional property `ocs/data/allOf[#/components/schemas/Room]/lastMessage/anyOf[#/components/schemas/ChatMessage]/allOf[subschema #2]/metaData/replyToConversationName` to the response with the `202` status
  - added the optional property `ocs/data/allOf[#/components/schemas/Room]/lastMessage/anyOf[#/components/schemas/ChatMessage]/allOf[subschema #2]/metaData/replyToConversationToken` to the response with the `202` status
  - added the optional property `ocs/data/allOf[#/components/schemas/Room]/lastMessage/anyOf[#/components/schemas/ChatMessage]/allOf[subschema #2]/metaData/replyToMessageId` to the response with the `202` status
  - added the optional property `ocs/data/lastMessage/anyOf[#/components/schemas/ChatMessage]/allOf[subschema #2]/metaData/replyToActorDisplayName` to the response with the `200` status
  - added the optional property `ocs/data/lastMessage/anyOf[#/components/schemas/ChatMessage]/allOf[subschema #2]/metaData/replyToActorDisplayName` to the response with the `201` status
  - added the optional property `ocs/data/lastMessage/anyOf[#/components/schemas/ChatMessage]/allOf[subschema #2]/metaData/replyToConversationName` to the response with the `200` status
  - added the optional property `ocs/data/lastMessage/anyOf[#/components/schemas/ChatMessage]/allOf[subschema #2]/metaData/replyToConversationName` to the response with the `201` status
  - added the optional property `ocs/data/lastMessage/anyOf[#/components/schemas/ChatMessage]/allOf[subschema #2]/metaData/replyToConversationToken` to the response with the `200` status
  - added the optional property `ocs/data/lastMessage/anyOf[#/components/schemas/ChatMessage]/allOf[subschema #2]/metaData/replyToConversationToken` to the response with the `201` status
  - added the optional property `ocs/data/lastMessage/anyOf[#/components/schemas/ChatMessage]/allOf[subschema #2]/metaData/replyToMessageId` to the response with the `200` status
  - added the optional property `ocs/data/lastMessage/anyOf[#/components/schemas/ChatMessage]/allOf[subschema #2]/metaData/replyToMessageId` to the response with the `201` status
- **2026-03-05** `99bd41590ecb`: 3 info
  - added the required property `ocs/data/allOf[#/components/schemas/Room]/attributes` to the response with the `202` status
  - added the required property `ocs/data/attributes` to the response with the `200` status
  - added the required property `ocs/data/attributes` to the response with the `201` status
- **2026-02-19** `0a08ea002cd5`: 1 info
  - added the new optional request property `preset`
- **2026-02-09** `2dd98af77e49`: 6 info
  - added the optional property `ocs/data/allOf[#/components/schemas/Room]/lastMessage/anyOf[#/components/schemas/ChatMessage]/allOf[subschema #2]/metaData/threadId` to the response with the `202` status
  - added the optional property `ocs/data/allOf[#/components/schemas/Room]/lastMessage/anyOf[#/components/schemas/ChatMessage]/allOf[subschema #2]/metaData/threadTitle` to the response with the `202` status
  - added the optional property `ocs/data/lastMessage/anyOf[#/components/schemas/ChatMessage]/allOf[subschema #2]/metaData/threadId` to the response with the `200` status
  - added the optional property `ocs/data/lastMessage/anyOf[#/components/schemas/ChatMessage]/allOf[subschema #2]/metaData/threadId` to the response with the `201` status
  - added the optional property `ocs/data/lastMessage/anyOf[#/components/schemas/ChatMessage]/allOf[subschema #2]/metaData/threadTitle` to the response with the `200` status
  - added the optional property `ocs/data/lastMessage/anyOf[#/components/schemas/ChatMessage]/allOf[subschema #2]/metaData/threadTitle` to the response with the `201` status
- **2026-01-30** `fb0a9a295f3a`: 1 info
  - the `permissions` request property's max was increased from `255.00` to `511.00`
- **2025-12-19** `e33f2a9ba885`: 3 breaking
  - the `ocs/data/allOf[#/components/schemas/Room]/hasScheduledMessages` response's property type changed from `boolean` to `integer`, and format from no format to `int64` for status `202`
  - the `ocs/data/hasScheduledMessages` response's property type changed from `boolean` to `integer`, and format from no format to `int64` for status `200`
  - the `ocs/data/hasScheduledMessages` response's property type changed from `boolean` to `integer`, and format from no format to `int64` for status `201`
- **2025-12-13** `836100158f59`: 9 info
  - request body became optional
  - the request property `listable` became optional
  - the request property `lobbyState` became optional
  - the request property `mentionPermissions` became optional
  - the request property `permissions` became optional
  - the request property `readOnly` became optional
  - the request property `recordingConsent` became optional
  - the request property `roomType` became optional
  - the request property `sipEnabled` became optional
- **2025-12-09** `6ef64fbefde3`: 3 info
  - added the required property `ocs/data/allOf[#/components/schemas/Room]/hasScheduledMessages` to the response with the `202` status
  - added the required property `ocs/data/hasScheduledMessages` to the response with the `200` status
  - added the required property `ocs/data/hasScheduledMessages` to the response with the `201` status
- **2025-11-04** `7dcb597c730d`: 3 info
  - added the optional property `ocs/data/allOf[#/components/schemas/Room]/lastMessage/anyOf[#/components/schemas/ChatMessage]/allOf[subschema #2]/metaData/pinnedAt` to the response with the `202` status
  - added the optional property `ocs/data/lastMessage/anyOf[#/components/schemas/ChatMessage]/allOf[subschema #2]/metaData/pinnedAt` to the response with the `200` status
  - added the optional property `ocs/data/lastMessage/anyOf[#/components/schemas/ChatMessage]/allOf[subschema #2]/metaData/pinnedAt` to the response with the `201` status
- **2025-11-04** `9f3989c87ab7`: 9 info
  - added the optional property `ocs/data/allOf[#/components/schemas/Room]/lastMessage/anyOf[#/components/schemas/ChatMessage]/allOf[subschema #2]/metaData` to the response with the `202` status
  - added the optional property `ocs/data/lastMessage/anyOf[#/components/schemas/ChatMessage]/allOf[subschema #2]/metaData` to the response with the `200` status
  - added the optional property `ocs/data/lastMessage/anyOf[#/components/schemas/ChatMessage]/allOf[subschema #2]/metaData` to the response with the `201` status
  - added the required property `ocs/data/allOf[#/components/schemas/Room]/hiddenPinnedId` to the response with the `202` status
  - added the required property `ocs/data/allOf[#/components/schemas/Room]/lastPinnedId` to the response with the `202` status
  - added the required property `ocs/data/hiddenPinnedId` to the response with the `200` status
  - added the required property `ocs/data/hiddenPinnedId` to the response with the `201` status
  - added the required property `ocs/data/lastPinnedId` to the response with the `200` status
  - added the required property `ocs/data/lastPinnedId` to the response with the `201` status
- **2025-09-02** `7551dadee4c3`: 6 info
  - added the optional property `ocs/data/allOf[#/components/schemas/Room]/lastMessage/anyOf[#/components/schemas/ChatMessage]/allOf[subschema #2]/threadReplies` to the response with the `202` status
  - added the optional property `ocs/data/allOf[#/components/schemas/Room]/lastMessage/anyOf[#/components/schemas/ChatMessage]/allOf[subschema #2]/threadTitle` to the response with the `202` status
  - added the optional property `ocs/data/lastMessage/anyOf[#/components/schemas/ChatMessage]/allOf[subschema #2]/threadReplies` to the response with the `200` status
  - added the optional property `ocs/data/lastMessage/anyOf[#/components/schemas/ChatMessage]/allOf[subschema #2]/threadReplies` to the response with the `201` status
  - added the optional property `ocs/data/lastMessage/anyOf[#/components/schemas/ChatMessage]/allOf[subschema #2]/threadTitle` to the response with the `200` status
  - added the optional property `ocs/data/lastMessage/anyOf[#/components/schemas/ChatMessage]/allOf[subschema #2]/threadTitle` to the response with the `201` status
- **2025-08-30** `3e9d3577cce9`: 1 info
  - added the non-success response with the status `401`
- **2025-08-29** `eff986f901a2`: 3 info
  - added the required property `ocs/data/allOf[#/components/schemas/Room]/liveTranscriptionLanguageId` to the response with the `202` status
  - added the required property `ocs/data/liveTranscriptionLanguageId` to the response with the `200` status
  - added the required property `ocs/data/liveTranscriptionLanguageId` to the response with the `201` status
- **2025-08-29** `188ccf695897`: 3 breaking
  - removed the required property `ocs/data/allOf[#/components/schemas/Room]/liveTranscriptionLanguageId` from the response with the `202` status
  - removed the required property `ocs/data/liveTranscriptionLanguageId` from the response with the `200` status
  - removed the required property `ocs/data/liveTranscriptionLanguageId` from the response with the `201` status
- **2025-08-29** `3bdce93d13d5`: 3 info
  - added the required property `ocs/data/allOf[#/components/schemas/Room]/liveTranscriptionLanguageId` to the response with the `202` status
  - added the required property `ocs/data/liveTranscriptionLanguageId` to the response with the `200` status
  - added the required property `ocs/data/liveTranscriptionLanguageId` to the response with the `201` status

---

[Operation](https://skmtc.dev/nextcloud/apis/spreed-full/docs/ocs/v2.php/apps/spreed/api/:apiVersion/room/post.md) - [API](https://skmtc.dev/nextcloud/apis/spreed-full.md) - [Page](https://skmtc.dev/nextcloud/apis/spreed-full/changes/ocs/v2.php/apps/spreed/api/:apiVersion/room/post)