Delete a business user role

QA Environment

https://qa-api.kiolinkapp.com

DELETE

/v1/businessroles/{id}

Business Roles

Last modified:2026-10-05 20:37:37

Maintainer:Not configured

Required Permission(s):business-roles-delete

Permanently deletes a business user role and records its permissions as removed in the permissions log. Business users with this role keep the dangling role ID.

Requires a session token whose role has the business-roles-delete permission.

Request

Authorization

API Key

Add parameter in header

authorization

Example:

authorization: ********************

or

Path Params

Request Code Samples

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request DELETE 'https://qa-api.kiolinkapp.com/v1/businessroles/65f1c2a9e4b0a1b2c3d4e5b2' \
--header 'authorization: <api-key>'

Responses

🟢200Role deleted

application/json

Role deleted.

Bodyapplication/json

Example

{
    "message": "Role deleted successfully"
}

🟠401The session token expired

🟠403Not authenticated (missing/invalid token, inactive user), or

🟠404The role does not exist

🔴500Unexpected error

Modified at 2026-10-05 20:37:37

Update a business user role