Skip to main content
DELETE
/
roles
/
{id}
curl -X DELETE https://api.companyflow.com/roles/550e8400-e29b-41d4-a716-446655440000 \
  -H "Authorization: Bearer YOUR_TOKEN"
{
  "success": true,
  "message": "role deleted"
}
Permanently delete a role. Requires Super Admin or HR Manager permissions.
This action cannot be undone. Ensure you want to delete this role before proceeding.

Path Parameters

id
string
required
The unique identifier of the role (UUID format)Example: "550e8400-e29b-41d4-a716-446655440000"

Response

success
boolean
Indicates if the request was successful
message
string
Confirmation message
curl -X DELETE https://api.companyflow.com/roles/550e8400-e29b-41d4-a716-446655440000 \
  -H "Authorization: Bearer YOUR_TOKEN"
{
  "success": true,
  "message": "role deleted"
}

Build docs developers (and LLMs) love