---
title: "Changes to Create Role"
method: POST
path: "/v1/admin/roles"
---

# Changes to Create Role

`POST /v1/admin/roles`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 6 of 21 revisions.

- **2026-09-29** `2f7a4a0aac8f`: 1 info
- **2026-09-29** `da70d9cd1957`: 1 breaking
- **2026-08-20** `0db3023472ef`: 1 breaking, 1 info
- **2026-05-06** `27a773824667`: 3 info
- **2026-04-30** `d5f1d3d5614e`: 13 info
- **2026-03-04** `46bc88767a37`: 10 breaking, 1 warning, 5 info

## Changes

- **2026-09-29** `2f7a4a0aac8f`: 1 info
  - endpoint added
- **2026-09-29** `da70d9cd1957`: 1 breaking
  - api path removed without deprecation
- **2026-08-20** `0db3023472ef`: 1 breaking, 1 info
  - removed the enum value `create_public_collection` of the request property `permissions/anyOf[subschema #1]/items/`
  - removed the `create_public_collection` enum value from the `permissions/items/` response property for the response status `201`
- **2026-05-06** `27a773824667`: 3 info
  - the request property `name` became optional
  - request property `name` list-of-types was widened by adding types `null` to media type `application/json`
  - the `name` request property's minLength was decreased from `1` to `0`
- **2026-04-30** `d5f1d3d5614e`: 13 info
  - the `limits` request property default value `` was removed
  - the `permissions` request property default value `` was removed
  - request property `limits` list-of-types was widened by adding types `null` to media type `application/json`
  - added the non-success response with the status `401`
  - added the non-success response with the status `403`
  - added the non-success response with the status `409`
  - added the optional property `object` to the response with the `201` status
  - added the required property `created` to the response with the `201` status
  - added the required property `limits` to the response with the `201` status
  - added the required property `name` to the response with the `201` status
  - added the required property `permissions` to the response with the `201` status
  - added the required property `updated` to the response with the `201` status
  - added the required property `users` to the response with the `201` status
- **2026-03-04** `46bc88767a37`: 10 breaking, 1 warning, 5 info
  - the request property `name` became required
  - request property `limits` list-of-types was narrowed by removing types `null` from media type `application/json`
  - request property `name` list-of-types was narrowed by removing types `null` from media type `application/json`
  - the `name` request property's minLength was increased from `0` to `1`
  - removed the required property `created` from the response with the `201` status
  - removed the required property `limits` from the response with the `201` status
  - removed the required property `name` from the response with the `201` status
  - removed the required property `permissions` from the response with the `201` status
  - removed the required property `updated` from the response with the `201` status
  - removed the required property `users` from the response with the `201` status
  - removed the optional property `object` from the response with the `201` status
  - the `limits` request property default value `` was added
  - the `permissions` request property default value `` was added
  - removed the non-success response with the status `401`
  - removed the non-success response with the status `403`
  - removed the non-success response with the status `409`

---

[Operation](https://skmtc.dev/betagouv/apis/opengatellm/docs/v1/admin/roles/post.md) - [API](https://skmtc.dev/betagouv/apis/opengatellm.md) - [Page](https://skmtc.dev/betagouv/apis/opengatellm/changes/v1/admin/roles/post)