Skip to main content

RemoveRole

Remove a role and its assignments.

Requires access_control.delete permission. No input or output blobs are used.

Parameters​

  • name (string, required): existing role.

Behavior​

The role is removed from every assigned user and their sessions are revoked in the same transaction. Users retain permissions granted by their remaining roles. A query execution failure rolls back the removal and revocations.

Response​

Success returns status: 0. Failures return a negative status and an info message; see Responses for error envelopes and retry guidance.

Examples​

[{
    "RemoveRole": {
        "name": "architect"
    }
}]

Response:

[{
    "RemoveRole": {
        "status": 0
    }
}]