Roles

Delete custom role

Delete a custom role. The role must not be in use by any member or API key — reassign them first or deletion will fail.

System roles cannot be deleted.

delete/api/v1/roles/{id}

Path parameters

idstring uuid required

Role ID (UUID)

Response

Role deleted

successboolean
messagestring

Example response

{
  "success": true,
  "message": "Operation completed successfully"
}

Changes