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

# Delete a custom role

`DELETE /v1/roles/{roleId}`

## Request

- Base URL: `https://docs.grepr.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://docs.grepr.ai/v1/roles/{roleId}`
- Auth: none declared

Deletes a custom role. System roles cannot be deleted.

## Path parameters

- `roleId` string, required

## Response `204`

Role deleted successfully

## Other responses

- `400`: Cannot delete system role or role in use
- `403`: Insufficient permissions
- `404`: Role not found

---

[API](https://skmtc.dev/grepr/apis/grepr-api.md) - [All operations](https://skmtc.dev/grepr/apis/grepr-api/llms.txt) - [OpenAPI document](https://skmtc.dev/grepr/apis/grepr-api/revisions/2a5ce03a0bf0?raw)