Skip to main content

mercato auth list-users

yarn mercato auth list-users prints a tabular view of users, including organization and tenant names plus role memberships.

Usage​

yarn mercato auth list-users [--organizationId <uuid>] [--tenantId <uuid>]

Aliases:

  • --org or --orgId for --organizationId.
  • --tenant for --tenantId.

Output​

The command renders a fixed-width table:

ID                                   | Email                   | Name                    | Organization ID      | Tenant ID            | Roles
-------------------------------------|-------------------------|-------------------------|---------------------|---------------------|-------------------
7c2a91be-7f06-4c6e-9c28-2507a5e5992e | manager@acme.dev        | Unnamed                 | Acme HQ...           | 81c3b8b0...          | admin, employee

If no users match the filters, the command prints No users found.

Tips​

  • Use it to grab user IDs before calling other commands such as password resets.
  • Combine with shell tools (grep, awk) to extract specific columns.
  • Tenant and organization filters accept UUIDs only; names are resolved in the output for readability.

Troubleshooting​

  • Wide output – pipe to less -S or redirect to a file when you have many users.
  • Performance – the command performs direct MikroORM queries; in very large datasets consider filtering by tenant to limit results.