mr groups list
List Groups, optionally filtered. Filter flags combine with AND.
Comma-separated ID lists on --tags and --groups require all of the
given IDs to match, not any of them: a group must carry every listed
tag, and be related to or owned by every listed group. Date flags
(--created-before, --created-after) expect YYYY-MM-DD or an
RFC 3339 timestamp. Pagination via the global --page flag (default
page size 50).
A zero --owner-id is ignored rather than treated as "no parent", so
there is no root-group filter here; use group children 0 to list
top-level groups. The JSON output is a flat array. Use
group children <id> for tree-structured traversal.
--mrql applies an MRQL filter expression, with type = "group"
implied (the same expression the list-page filter bar accepts). It uses
the WHERE-clause grammar only -- no ORDER BY, LIMIT, GROUP BY,
SCOPE, or $name parameters -- and composes with the other filter
flags via AND. Example: --mrql 'descendants.category = "Archive"'.
Usage
mr groups list
Examples
List all groups (paged)
mr groups list
Filter by name prefix
mr groups list --name "Trips"
Filter by owner and tag
mr groups list --owner-id 5 --tags 3 --json | jq -r '.[].Name'
Filter with an MRQL expression (type = "group" implied)
mr groups list --mrql 'name ~ "Trips"'
Flags
| Flag | Type | Default | Description |
|---|---|---|---|
--name | string | `` | Filter by name |
--description | string | `` | Filter by description |
--tags | string | `` | Comma-separated tag IDs to filter by |
--groups | string | `` | Comma-separated group IDs to filter by |
--owner-id | uint | 0 | Filter by owner group ID |
--category-id | uint | 0 | Filter by category ID |
--url | string | `` | Filter by URL |
--created-before | string | `` | Filter by creation date (before) |
--created-after | string | `` | Filter by creation date (after) |
--mrql | string | `` | MRQL filter expression (type = "group" implied), e.g. 'descendants.category = "Archive"' |
Inherited global flags
| Flag | Type | Default | Description |
|---|---|---|---|
--json | bool | false | Output raw JSON |
--no-header | bool | false | Omit table headers |
--page | int | 1 | Page number for list commands (default page size: 50) |
--quiet | bool | false | Only output IDs |
--server | string | http://localhost:8181 | mahresources server URL (env: MAHRESOURCES_URL) |
Output
Array of Group objects with ID, Name, Description, Meta, OwnerId, CategoryId, CreatedAt/UpdatedAt
Exit Codes
0 on success; 1 on any error