Delete role
Delete a custom role. System roles cannot be deleted. Ensure no users or API credentials are assigned the role before deleting.
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
id | UUID | Yes | Role identifier |
Use Cases
- Remove obsolete custom roles
- Clean up role structure
- Consolidate roles
Required Permission
roles:delete
Delete role
Delete a custom role. System roles cannot be deleted. Ensure no users or API credentials are assigned the role before deleting.
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
id | UUID | Yes | Role identifier |
Use Cases
- Remove obsolete custom roles
- Clean up role structure
- Consolidate roles
Required Permission
roles:delete