---
title: "Changes to Create a new group"
method: POST
path: "/groups"
---

# Changes to Create a new group

`POST /groups`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 13 of 126 revisions.

- **2026-10-31** `ff9684af2aad`: 25 info
- **2026-10-29** `f17f5df4e79c`: 5 info
- **2026-01-14** `31fa45cad70b`: 1 info
- **2025-12-16** `440db8997574`: 2 info
- **2025-10-21** `06cfd568ee49`: 2 breaking
- **2024-09-06** `948bffd5d083`: 4 warning, 8 info
- **2024-05-29** `f218e9fd88af`: 1 breaking, 1 warning
- **2024-03-13** `b4b182eb7468`: 1 breaking, 1 info
- **2024-02-16** `8ec5f92da35d`: 1 breaking, 1 info
- **2024-02-13** `c00c5341e20e`: 1 breaking, 1 info
- **2024-02-07** `d761f09f101e`: 1 warning, 1 info
- **2024-01-25** `35e85f455b84`: 1 info
- **2022-11-01** `c4471e2479ed`: 1 info

## Changes

- **2026-10-31** `ff9684af2aad`: 25 info
  - added the optional property `ruleViolation/causes/items/code` to the response with the `400` status
  - added the optional property `ruleViolation/causes/items/code` to the response with the `401` status
  - added the optional property `ruleViolation/causes/items/code` to the response with the `403` status
  - added the optional property `ruleViolation/causes/items/code` to the response with the `409` status
  - added the optional property `ruleViolation/causes/items/code` to the response with the `500` status
  - added the optional property `ruleViolation/causes/items/direction` to the response with the `400` status
  - added the optional property `ruleViolation/causes/items/direction` to the response with the `401` status
  - added the optional property `ruleViolation/causes/items/direction` to the response with the `403` status
  - added the optional property `ruleViolation/causes/items/direction` to the response with the `409` status
  - added the optional property `ruleViolation/causes/items/direction` to the response with the `500` status
  - added the optional property `ruleViolation/causes/items/existing` to the response with the `400` status
  - added the optional property `ruleViolation/causes/items/existing` to the response with the `401` status
  - added the optional property `ruleViolation/causes/items/existing` to the response with the `403` status
  - added the optional property `ruleViolation/causes/items/existing` to the response with the `409` status
  - added the optional property `ruleViolation/causes/items/existing` to the response with the `500` status
  - added the optional property `ruleViolation/causes/items/proposed` to the response with the `400` status
  - added the optional property `ruleViolation/causes/items/proposed` to the response with the `401` status
  - added the optional property `ruleViolation/causes/items/proposed` to the response with the `403` status
  - added the optional property `ruleViolation/causes/items/proposed` to the response with the `409` status
  - added the optional property `ruleViolation/causes/items/proposed` to the response with the `500` status
  - added the optional property `ruleViolation/ruleType` to the response with the `400` status
  - added the optional property `ruleViolation/ruleType` to the response with the `401` status
  - added the optional property `ruleViolation/ruleType` to the response with the `403` status
  - added the optional property `ruleViolation/ruleType` to the response with the `409` status
  - added the optional property `ruleViolation/ruleType` to the response with the `500` status
- **2026-10-29** `f17f5df4e79c`: 5 info
  - added the optional property `ruleViolation` to the response with the `400` status
  - added the optional property `ruleViolation` to the response with the `401` status
  - added the optional property `ruleViolation` to the response with the `403` status
  - added the optional property `ruleViolation` to the response with the `409` status
  - added the optional property `ruleViolation` to the response with the `500` status
- **2026-01-14** `31fa45cad70b`: 1 info
  - added the non-success response with the status `400`
- **2025-12-16** `440db8997574`: 2 info
  - added the non-success response with the status `401`
  - added the non-success response with the status `403`
- **2025-10-21** `06cfd568ee49`: 2 breaking
  - the response property `description` became optional for the status `200`
  - the response property `labels` became optional for the status `200`
- **2024-09-06** `948bffd5d083`: 4 warning, 8 info
  - removed the optional property `error_code` from the response with the `409` status
  - removed the optional property `error_code` from the response with the `500` status
  - removed the optional property `message` from the response with the `409` status
  - removed the optional property `message` from the response with the `500` status
  - added the optional property `instance` to the response with the `409` status
  - added the optional property `instance` to the response with the `500` status
  - added the optional property `type` to the response with the `409` status
  - added the optional property `type` to the response with the `500` status
  - added the required property `status` to the response with the `409` status
  - added the required property `status` to the response with the `500` status
  - added the required property `title` to the response with the `409` status
  - added the required property `title` to the response with the `500` status
- **2024-05-29** `f218e9fd88af`: 1 breaking, 1 warning
  - added the new required request property `groupId`
  - removed the request property `id`
- **2024-03-13** `b4b182eb7468`: 1 breaking, 1 info
  - removed the required property `id` from the response with the `200` status
  - added the required property `groupId` to the response with the `200` status
- **2024-02-16** `8ec5f92da35d`: 1 breaking, 1 info
  - removed the required property `createdBy` from the response with the `200` status
  - added the required property `owner` to the response with the `200` status
- **2024-02-13** `c00c5341e20e`: 1 breaking, 1 info
  - removed the required property `properties` from the response with the `200` status
  - added the required property `labels` to the response with the `200` status
- **2024-02-07** `d761f09f101e`: 1 warning, 1 info
  - removed the request property `properties`
  - added the new optional request property `labels`
- **2024-01-25** `35e85f455b84`: 1 info
  - the `id` response's property pattern `^.{1,512}$` was added for the status `200`
- **2022-11-01** `c4471e2479ed`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/apicurio/apis/apicurio-registry-api-v3/docs/groups/post.md) - [API](https://skmtc.dev/apicurio/apis/apicurio-registry-api-v3.md) - [Page](https://skmtc.dev/apicurio/apis/apicurio-registry-api-v3/changes/groups/post)
