---
title: "Changes to createRole"
method: POST
path: "/v1/permissions/roles"
---

# Changes to createRole

`POST /v1/permissions/roles`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 2 of 4 revisions.

- **2026-09-30** `546c43723a60`: 2 info
- **2026-08-27** `b29ea9adf72b`: 3 breaking, 16 info

## Changes

- **2026-09-30** `546c43723a60`: 2 info
  - added the new optional request property `allOf[subschema #3]/oneOf[subschema #5]/portal_id`
  - added the optional property `oneOf[#/components/schemas/PortalRole]/allOf[subschema #2]/portal_id` to the response with the `200` status
- **2026-08-27** `b29ea9adf72b`: 3 breaking, 16 info
  - the `allOf[#/components/schemas/BaseRoleForCreate]/grants/items/conditions/items/allOf[subschema #2]/anyOf[#/components/schemas/EqualsCondition]/values` request property's minItems was increased to `1`
  - the `allOf[subschema #1]/grants/items/allOf[#/components/schemas/Grant]/conditions/items/allOf[subschema #2]/anyOf[#/components/schemas/EqualsCondition]/values` request property's minItems was increased to `1`
  - the `allOf[subschema #1]/grants/items/allOf[subschema #2]/dependencies/items/conditions/items/allOf[subschema #2]/anyOf[#/components/schemas/EqualsCondition]/values` request property's minItems was increased to `1`
  - added the new optional request property `allOf[#/components/schemas/BaseRoleForCreate]/grants/items/conditions/items/allOf[subschema #2]/anyOf[#/components/schemas/EqualsCurrentUserCondition]/attributes`
  - added the new optional request property `allOf[subschema #1]/grants/items/allOf[#/components/schemas/Grant]/conditions/items/allOf[subschema #2]/anyOf[#/components/schemas/EqualsCurrentUserCondition]/attributes`
  - added the new optional request property `allOf[subschema #1]/grants/items/allOf[subschema #2]/dependencies/items/conditions/items/allOf[subschema #2]/anyOf[#/components/schemas/EqualsCurrentUserCondition]/attributes`
  - added `#/components/schemas/NotEqualsCondition, #/components/schemas/NotEqualsCurrentUserCondition` to the `allOf[#/components/schemas/BaseRoleForCreate]/grants/items/conditions/items/allOf[subschema #2]/` request property `anyOf` list
  - added `#/components/schemas/NotEqualsCondition, #/components/schemas/NotEqualsCurrentUserCondition` to the `allOf[subschema #1]/grants/items/allOf[#/components/schemas/Grant]/conditions/items/allOf[subschema #2]/` request property `anyOf` list
  - added `#/components/schemas/NotEqualsCondition, #/components/schemas/NotEqualsCurrentUserCondition` to the `allOf[subschema #1]/grants/items/allOf[subschema #2]/dependencies/items/conditions/items/allOf[subschema #2]/` request property `anyOf` list
  - added the optional property `oneOf[#/components/schemas/OrgRole]/allOf[#/components/schemas/BaseRole]/grants/items/conditions/items/allOf[subschema #2]/anyOf[#/components/schemas/EqualsCurrentUserCondition]/attributes` to the response with the `200` status
  - added the optional property `oneOf[#/components/schemas/PartnerRole]/allOf[#/components/schemas/BaseRole]/grants/items/conditions/items/allOf[subschema #2]/anyOf[#/components/schemas/EqualsCurrentUserCondition]/attributes` to the response with the `200` status
  - added the optional property `oneOf[#/components/schemas/PortalRole]/allOf[#/components/schemas/BaseRole]/grants/items/conditions/items/allOf[subschema #2]/anyOf[#/components/schemas/EqualsCurrentUserCondition]/attributes` to the response with the `200` status
  - added the optional property `oneOf[#/components/schemas/ShareRole]/allOf[#/components/schemas/BaseRole]/grants/items/conditions/items/allOf[subschema #2]/anyOf[#/components/schemas/EqualsCurrentUserCondition]/attributes` to the response with the `200` status
  - added the optional property `oneOf[#/components/schemas/UserRole]/allOf[#/components/schemas/BaseRole]/grants/items/conditions/items/allOf[subschema #2]/anyOf[#/components/schemas/EqualsCurrentUserCondition]/attributes` to the response with the `200` status
  - added `#/components/schemas/NotEqualsCondition, #/components/schemas/NotEqualsCurrentUserCondition` to the `oneOf[#/components/schemas/OrgRole]/allOf[#/components/schemas/BaseRole]/grants/items/conditions/items/allOf[subschema #2]/` response property `anyOf` list for the response status `200`
  - added `#/components/schemas/NotEqualsCondition, #/components/schemas/NotEqualsCurrentUserCondition` to the `oneOf[#/components/schemas/PartnerRole]/allOf[#/components/schemas/BaseRole]/grants/items/conditions/items/allOf[subschema #2]/` response property `anyOf` list for the response status `200`
  - added `#/components/schemas/NotEqualsCondition, #/components/schemas/NotEqualsCurrentUserCondition` to the `oneOf[#/components/schemas/PortalRole]/allOf[#/components/schemas/BaseRole]/grants/items/conditions/items/allOf[subschema #2]/` response property `anyOf` list for the response status `200`
  - added `#/components/schemas/NotEqualsCondition, #/components/schemas/NotEqualsCurrentUserCondition` to the `oneOf[#/components/schemas/ShareRole]/allOf[#/components/schemas/BaseRole]/grants/items/conditions/items/allOf[subschema #2]/` response property `anyOf` list for the response status `200`
  - added `#/components/schemas/NotEqualsCondition, #/components/schemas/NotEqualsCurrentUserCondition` to the `oneOf[#/components/schemas/UserRole]/allOf[#/components/schemas/BaseRole]/grants/items/conditions/items/allOf[subschema #2]/` response property `anyOf` list for the response status `200`

---

[Operation](https://skmtc.dev/epilot/apis/permissions-api/docs/v1/permissions/roles/post.md) - [API](https://skmtc.dev/epilot/apis/permissions-api.md) - [Page](https://skmtc.dev/epilot/apis/permissions-api/changes/v1/permissions/roles/post)