# Delete a custom role **DELETE** `/v1/roles/{roleId}` **Operation ID**: `deleteRole` **Summary**: Delete a custom role Deletes a custom role. System roles cannot be deleted. ## Tags - Roles ## Parameters - **roleId** (required) - path - Type: string ## Responses ### 204 Role deleted successfully ### 400 Cannot delete system role or role in use ### 403 Insufficient permissions ### 404 Role not found