List capsules visible to the caller
Query parameters
Filter to a single Type by id.
Filter to a single Type by id.
Filter to a collection by id. Requires typeId.
Filter to a collection by id. Requires typeId.
Set to true to list archived capsules instead of active ones.
Set to true to list archived capsules instead of active ones.
Filter to a single Project by id.
Filter to a single Project by id.
Set to true (or 1) to return only capsules that are Skills.
Set to true (or 1) to return only capsules that are Skills.
Filter to capsules carrying this tag.
Filter to capsules carrying this tag.
Filter to capsules in this category slug.
Filter to capsules in this category slug.
Relative recency window — only capsules created within it.
Relative recency window — only capsules created within it.
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.
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.
Opaque keyset cursor from a previous page's nextCursor.
Opaque keyset cursor from a previous page's nextCursor.
Page size, 1–100. Defaults to 30.
Page size, 1–100. Defaults to 30.
Sort order. The valid keys depend on the list context: newest, oldest, updated, title_asc for all capsules; ref_desc, ref_asc (plus newest, updated, title_asc) within a Type; archived_newest, archived_oldest (plus newest, title_asc) when archived=true. An out-of-context key is rejected.
Sort order. The valid keys depend on the list context: newest, oldest, updated, title_asc for all capsules; ref_desc, ref_asc (plus newest, updated, title_asc) within a Type; archived_newest, archived_oldest (plus newest, title_asc) when archived=true. An out-of-context key is rejected.
Opt-in response size budget in bytes (size-budgeted paging).
Opt-in response size budget in bytes (size-budgeted paging).
Row content projection on the size-budgeted path. Defaults to metadata.
Row content projection on the size-budgeted path. Defaults to metadata.
Comma-separated opt-in heavy columns to include on full rows.
Comma-separated opt-in heavy columns to include on full rows.
Opt-in enrichments. cover attaches each card's featured image (web only).
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.
Optional workspace context for the request. Same value rules as the MCP workspace tool argument. Omit to use the caller's default workspace.
Response
Successful response