---
title: "Changes to Create a role"
method: POST
path: "/api/v1/roles"
---

# Changes to Create a role

`POST /api/v1/roles`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 7 of 19 revisions.

- **2021-08-09** `214f3986034a` — 2 info
- **2021-08-06** `e3cb40d13d06` — 2 warning, 2 info
- **2021-08-06** `3c703fa51ebd` — 3 info
- **2021-08-06** `e366ae458db2` — 1 warning, 1 info
- **2021-08-05** `bf593e163365` — 2 warning, 3 info
- **2021-08-05** `c440d3b4a9b9` — 1 breaking, 3 info
- **2019-08-15** `42619b8ccbbe` — 1 info

## Changes

- **2021-08-09** `214f3986034a` — 2 info
  - added the optional property `description` to the response with the `200` status
  - added the optional property `isGlobal` to the response with the `200` status
- **2021-08-06** `e3cb40d13d06` — 2 warning, 2 info
  - removed the optional property `isCreated` from the response with the `200` status
  - removed the optional property `isUpdated` from the response with the `200` status
  - added the optional property `createdAt` to the response with the `200` status
  - added the optional property `updatedAt` to the response with the `200` status
- **2021-08-06** `3c703fa51ebd` — 3 info
  - added the optional property `id` to the response with the `200` status
  - added the optional property `isCreated` to the response with the `200` status
  - added the optional property `isUpdated` to the response with the `200` status
- **2021-08-06** `e366ae458db2` — 1 warning, 1 info
  - removed the optional property `description` from the response with the `200` status
  - added the optional property `scope` to the response with the `200` status
- **2021-08-05** `bf593e163365` — 2 warning, 3 info
  - removed the request property `scope`
  - removed the optional property `scope` from the response with the `200` status
  - added the new optional request property `description`
  - added the new optional request property `isGlobal`
  - added the optional property `description` to the response with the `200` status
- **2021-08-05** `c440d3b4a9b9` — 1 breaking, 3 info
  - the request's body type/format changed from ``/`` to `object`/``
  - added the new optional request property `name`
  - added the new optional request property `permissions`
  - added the new optional request property `scope`
- **2019-08-15** `42619b8ccbbe` — 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/openintegrationhub/apis/iam-api-for-oih/docs/api/v1/roles/post.md) · [API](https://skmtc.dev/openintegrationhub/apis/iam-api-for-oih.md) · [Page](https://skmtc.dev/openintegrationhub/apis/iam-api-for-oih/changes/api/v1/roles/post)