v2

latestOpenAPI 3.0.3Apache 2.02026-08-0715707.5 MB
Roles

Deactivate a role by ID

Deactivates the role specified by its ID. The role remains queryable with status DEACTIVATED. Only roles whose entity_type is BUSINESS may be deactivated via this endpoint; account-group roles are rejected with 403 Forbidden. Deactivation is a terminal state; once deactivated, a role cannot be reactivated. Deactivation is idempotent: calling this endpoint on an already-deactivated role returns 202 Accepted without side effects. A ROLE.DEACTIVATED webhook event is emitted on the first successful deactivation.

delete/roles/{role_id}

Response

The request has been successfully accepted and will be processed asynchronously.