users
List RouterOS login accounts with group, allowed source, last login, disabled state, and comment. Read-only; returns an empty list if the endpoint is unavailable.
Instructions
List RouterOS login accounts (/user): name, group,
address (an allowed-source restriction, if the account has one),
last-logged-in (if RouterOS exposes it), disabled, comment.
/user's own API reply never carries a password at all - RouterOS
doesn't expose it over the API, so there is nothing to strip here
(unlike ppp_secrets/radius, whose underlying menus DO carry a
secret). This is a READ only: creating/editing a /user login stays
deliberately out of scope for this package (see ROADMAP.md's
"Explicitly NOT on the roadmap" - a router login is a device/API
credential, a different risk class from a service credential like a
PPP secret or hotspot user).
Returns an empty list (never an error) if /user is unavailable for
some reason - /user always exists on RouterOS in practice, but this
keeps the same "empty, not an error" convention every other optional
read in this package uses.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| device_name | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |