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
    }
}]