.. _RemoveRole: 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 :doc:`../Responses` for error envelopes and retry guidance. Examples -------- .. TESTED_EXAMPLE: RemoveRole_1 .. code-block:: json [{ "RemoveRole": { "name": "architect" } }] Response: .. TESTED_EXAMPLE: RemoveRole_1_response .. code-block:: json [{ "RemoveRole": { "status": 0 } }]