---
title: "Changes to Delete a custom role"
method: DELETE
path: "/v1/roles/{roleId}"
---

# Changes to Delete a custom role

`DELETE /v1/roles/{roleId}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 3 of 64 revisions.

- **2026-10-26** `7fe59d94a9f5`: 4 info
- **2026-10-22** `551a288b9aa0`: 1 breaking
- **2026-10-10** `12b2fcbcc298`: 1 info

## Changes

- **2026-10-26** `7fe59d94a9f5`: 4 info
  - added the optional property `requestId` to the response with the `401` status
  - added the optional property `requestId` to the response with the `403` status
  - added the optional property `requestId` to the response with the `404` status
  - added the optional property `requestId` to the response with the `409` status
- **2026-10-22** `551a288b9aa0`: 1 breaking
  - removed the required property `serviceAccounts` from the response with the `409` status
- **2026-10-10** `12b2fcbcc298`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/openrelay/apis/openrelay-api/docs/v1/roles/:roleId/delete.md) - [API](https://skmtc.dev/openrelay/apis/openrelay-api.md) - [Page](https://skmtc.dev/openrelay/apis/openrelay-api/changes/v1/roles/:roleId/delete)