List capsules visible to the caller

Filter to a single Type by id.

Filter to a collection by id. Requires typeId.

Set to true to list archived capsules instead of active ones.

Filter to a single Project by id.

Set to true (or 1) to return only capsules that are Skills.

Filter to capsules carrying this tag.

Filter to capsules in this category slug.

Relative window on creation date: an integer 1-9999 followed by h, d, or w (e.g. 8h, 3d, 2w). The legacy 24h/7d/30d values still work.

Named calendar window on creation date, resolved in the effective timezone.

Inclusive lower bound on creation date. An ISO-8601 instant (2026-09-01T00:00:00Z), or an offset-less date or date-time (2026-09-01) read in the effective timezone.

Exclusive upper bound on creation date. Same spellings as created_after.

Relative window on last-updated date (same grammar as created_within).

Named calendar window on last-updated date, resolved in the effective timezone.

Inclusive lower bound on last-updated date. Same spellings as created_after.

Exclusive upper bound on last-updated date. Same spellings as created_after.

Relative window on archived date. Only valid with archived=true.

Named calendar window on archived date. Only valid with archived=true.

Inclusive lower bound on archived date. Same spellings as created_after. Only valid with archived=true.

Exclusive upper bound on archived date. Same spellings as created_after. Only valid with archived=true.

IANA timezone name (e.g. America/New_York) that named calendar periods resolve in for this request, overriding the caller's stored timezone.

Set to true to return only stale capsules, or false to exclude stale ones. Absent leaves staleness unfiltered. true is not valid with archived=true — archived capsules are never stale.

Set to true to list only unfinished (capture-first) capsules still awaiting completion. Honoured on the active list only; the archived view is history, not a work queue.

Total over ALL matching capsules: count, or <op>:<field> where op is sum, avg, min or max over a number field. Returned as a top-level aggregate object; an empty match gives count 0 and value null. Requires typeId; a derived field is refused.

Opaque keyset cursor from a previous page's nextCursor.

Page size, 1–100. Defaults to 30.

Sort order. Either a context key or a field sort. The context keys each listing accepts, its default marked: All capsules: newest (default), oldest, updated, title_asc. Within a Type (typeId): ref_desc (default), ref_asc, newest, updated, title_asc. Archived (archived=true): archived_newest (default), archived_oldest, newest, title_asc. A field sort is field:<name>:asc|desc (issue #2105), valid only with typeId, over a sortable non-derived field. An out-of-context key or an unsortable/derived field is rejected.

Opt-in response size budget in bytes (size-budgeted paging).

Row content projection on the size-budgeted path. Defaults to metadata.

Comma-separated opt-in heavy columns to include on full rows.

Assistant row shape for the size-budgeted page (maxBytes). Rows leave out keys at their default value and display-only keys, attachment previews carry only attachment facts, and on a typeId listing that returned rows the rows leave out their Type identity, which the page then carries once as type. No effect on a select page: its rows carry exactly the named fields and the page gets no type. No effect for a caller that does not reach the size-budgeted page.

Comma-separated row selection: each row carries only id, ref and the named fields, for example title,summary,field_values.status. Accepts any full-listing field, content_excerpt, ref, bare field_values (every value) or field_values.<name> (one declared, non-derived field; requires typeId). Cannot be combined with contentLevel or fields. A selected page is size-budgeted and may return up to limit rows. API-key and MCP callers only; a web session gets a 400.

Opt-in enrichments. cover attaches each card's featured image (web only).

Optional workspace context for the request. Same value rules as the MCP workspace tool argument. Omit to use the caller's default workspace.