mr resources list

List Resources, optionally filtered. Filter flags combine with AND. Comma-separated ID lists on --tags, --groups, --notes are conjunctive: a resource must carry every ID in the list. Pass a single ID to match on one. Date flags (--created-before, --created-after) accept YYYY-MM-DD or an RFC 3339 timestamp. Sort with --sort-by=created_at,name; append desc or asc to an entry to set its direction (--sort-by='name desc'). Names are lowercase database columns, and an entry the server does not recognise is ignored. Pagination via the global --page flag (default page size 50).

--include-subgroups widens --owner-id to the whole group subtree: resources owned by the given group or by any of its descendant subgroups, recursively. It has no effect without --owner-id.

--mrql applies an MRQL filter expression, with type = "resource" 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. An invalid expression returns an error. Example: --mrql 'tags = "vacation" AND created > -30d'.

Usage

mr resources list

Examples

List all resources (paged)

mr resources list

Filter by content type

mr resources list --content-type image/jpeg

Filter by tag + date

mr resources list --tags 5 --created-after 2026-01-01 --json | jq -r '.[].Name'

Filter with an MRQL expression (type = "resource" implied)

mr resources list --mrql 'tags = "vacation" AND created > -30d'

Flags

Flag	Type	Default	Description
--name	string	``	Filter by name
--description	string	``	Filter by description
--content-type	string	``	Filter by content type
--owner-id	uint	0	Filter by owner group ID
--include-subgroups	bool	false	With --owner-id: also match resources owned by descendant subgroups
--tags	string	``	Comma-separated tag IDs to filter by
--groups	string	``	Comma-separated group IDs to filter by
--notes	string	``	Comma-separated note IDs to filter by
--resource-category-id	uint	0	Filter by resource category ID
--created-before	string	``	Filter by creation date (before)
--created-after	string	``	Filter by creation date (after)
--min-width	uint	0	Minimum width
--min-height	uint	0	Minimum height
--max-width	uint	0	Maximum width
--max-height	uint	0	Maximum height
--hash	string	``	Filter by hash
--original-name	string	``	Filter by original name
--mrql	string	``	MRQL filter expression (type = "resource" implied), e.g. 'tags = "vacation" AND created > -30d'
--sort-by	string	``	Comma-separated sort fields

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 resources with id, name, content type, size, dimensions, owner id, created

Exit Codes

0 on success; 1 on any error

See Also

• mr resource get
• mr groups list
• mr mrql