Skip to main content
DELETE
http://localhost:3000
/
roles
/
{id}
curl -X DELETE 'https://api.example.com/roles/role_123' \
  -H 'Authorization: Bearer YOUR_TOKEN'

{
  "success": true
}

​
Path Parameters

​
id
string
required
The unique identifier of the role to delete

​
Response

Returns a success confirmation.
Deleting a role will also remove all role assignments and role-permission mappings associated with it.
curl -X DELETE 'https://api.example.com/roles/role_123' \
  -H 'Authorization: Bearer YOUR_TOKEN'

{
  "success": true
}