Skip to main content
DELETE /api/v1/roles/{id} Requires roles.delete permission. Roles that are currently assigned to one or more members cannot be deleted.

Path parameters

id
string
required
UUID of the role to delete.

Response

deleted
boolean
required
Always true on success.

Errors

StatusWhen
401Missing or invalid Bearer token
403Caller lacks roles.delete permission
404Role not found
409Role is a system role or is currently assigned to one or more members

Example

curl -X DELETE http://localhost:8080/api/v1/roles/r2b2c3d4-e5f6-7890-abcd-ef1234567890 \
  -H "Authorization: Bearer <token>"
{
  "deleted": true
}

Build docs developers (and LLMs) love