Delete role

Deletes a custom role. Built-in system roles cannot be deleted and return 403.

DELETE /api/roles/{id}

Error

A valid request URL is required to generate request examples

200

{
  "message": "<string>"
}

Authorizations

Authorization · string · header · required

Management API authentication for /api/* endpoints. Use the Authorization header with Bearer <API key>. Virtual keys, dashboard/user/session tokens, and x-api-key headers are not supported on management APIs.

Path Parameters

id · integer · required

Response

200

application/json

Role deleted

message · string