capsule

List capsules visible to the caller

get/api/preview/capsules

Query parameters

typeIdstring

Filter to a single Type by id.

Filter to a single Type by id.

collectionIdstring

Filter to a collection by id. Requires typeId.

Filter to a collection by id. Requires typeId.

archived'true' | 'false'

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

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

projectIdstring

Filter to a single Project by id.

Filter to a single Project by id.

skillstring

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

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

tagstring

Filter to capsules carrying this tag.

Filter to capsules carrying this tag.

categorystring

Filter to capsules in this category slug.

Filter to capsules in this category slug.

created_within'24h' | '7d' | '30d'

Relative recency window — only capsules created within it.

Relative recency window — only capsules created within it.

incomplete'true' | 'false'

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.

cursorstring

Opaque keyset cursor from a previous page's nextCursor.

Opaque keyset cursor from a previous page's nextCursor.

limitinteger

Page size, 1–100. Defaults to 30.

Page size, 1–100. Defaults to 30.

sort'newest' | 'oldest' | 'updated' | 'title_asc' | 'ref_desc' | 'ref_asc' | 'archived_newest' | 'archived_oldest'

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.

maxBytesinteger

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

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

contentLevel'metadata' | 'full'

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

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

fieldsstring

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

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

includestring

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

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

wsstring

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

hasMoreboolean
nextCursorstring nullable

Changes