Skip to main content

RemoveUser

Delete a user and revoke their sessions and personal tokens.

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

Parameters​

  • username (string, required): existing user.

Behavior​

The admin user and the last user assigned the admin role cannot be removed. The telemetry account is also protected when configured. User removal and session revocation commit with the query; a failed execution rolls both back.

Response​

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

Examples​

[{
    "RemoveUser": {
        "username": "john"
    }
}]

Response:

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