---
title: "Changes to Update"
method: POST
path: "/api/v1/iam/roles/{role_id}"
---

# Changes to Update

`POST /api/v1/iam/roles/{role_id}`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 2 of 33 revisions.

- **2026-08-21** `f2cf3228f366` — 4 breaking, 13 warning, 1 info
- **2025-04-10** `17f9f3bcedd5` — 1 info

## Changes

- **2026-08-21** `f2cf3228f366` — 4 breaking, 13 warning, 1 info
  - the request property `updateMask` became not nullable
  - the `role` request property type/format changed from `object`/`` to ``/``
  - added `#/components/schemas/c1.api.iam.v1.Role, subschema #2` to the `role` response property `oneOf` list for the response status `200`
  - the `role` response's property type/format changed from `object`/`` to ``/`` for status `200`
  - removed the request property `role/displayName`
  - removed the request property `role/permissions`
  - removed the request property `role/serviceRoles`
  - removed the optional property `role/createdAt` from the response with the `200` status
  - removed the optional property `role/deletedAt` from the response with the `200` status
  - removed the optional property `role/displayName` from the response with the `200` status
  - removed the optional property `role/id` from the response with the `200` status
  - removed the optional property `role/name` from the response with the `200` status
  - removed the optional property `role/permissions` from the response with the `200` status
  - removed the optional property `role/serviceRoles` from the response with the `200` status
  - removed the optional property `role/systemApiOnly` from the response with the `200` status
  - removed the optional property `role/systemBuiltin` from the response with the `200` status
  - removed the optional property `role/updatedAt` from the response with the `200` status
  - added `#/components/schemas/c1.api.iam.v1.Role, subschema #2` to the `role` request property `oneOf` list
- **2025-04-10** `17f9f3bcedd5` — 1 info
  - endpoint added

---

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