---
title: "Delete a custom role"
method: DELETE
path: "/v1/roles/{roleId}"
tags: ["Role Management"]
---

# Delete a custom role

`DELETE /v1/roles/{roleId}`

Deletes an Enterprise custom role when it is not assigned to any organization members. System roles cannot be deleted.

## Path parameters

- `roleId` string, required

## Query parameters

- `org_id` string

## Response `204`

Custom role deleted

---

[API](https://skmtc.net/coderabbit/apis/coderabbit-api-spec.md) · [All operations](https://skmtc.net/coderabbit/apis/coderabbit-api-spec/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/coderabbit/coderabbit-api-spec/versions/401789d85d01/schema)