Delete Roles

DELETE

https://Example-Server.com/be/v1/roles/{roleName}

Last modified:2025-05-07 10:44:24

This endpoint deletes a role.

This operation cannot be undone.

Required Permissions

roles.delete

See Roles for more details.

Request

Path Params

Header Params

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request DELETE 'https://Example-Server.com/be/v1/roles/exampleRole' \
--header 'x-rockit-beauth-token: eyjhvcIhvds;huVODV...' \
--header 'x-rockit-orgname: ExampleOrg' \
--header 'x-rockit-username: adminPrincipal' \
--header 'x-rockit-api-key: {{_adminPrincipal_apiKey}}'

Responses

🟢200Success

application/json

Body

Example

{"status":"success","message":"role deleted"}

🟠400Invalid Param

🟠401Unauthorized

🟠409Item protected

Modified at 2025-05-07 10:44:24

Role Details

Changelog

Delete Roles

Required Permissions#

Request

Request samples

Responses

Required Permissions