Q2 2025 Roadmap: Request a beta API key and access upcoming features: Embedded Notifications, Team Communications and more.

Delete a specific role

DELETE

/api/organizations/{organization_id}/roles/{id}

roles

Deletes a specific role by its ID.

Response Example

200 - Success

{
  "message": "Role ID role_001 deleted successfully."
}

Request

Path Params

organization_id

string

required

The unique identifier of the organization to which the role belongs.

Example:

org_12345

string

required

The unique identifier of the role to delete.

Example:

role_001

🟢200OK

application/json

The role was deleted successfully.

Body

message

string

optional

A success message.

Example:

Role deleted successfully.

🟠404Record Not Found