List Disks
Reference
List Disks
List, search, and filter owned and active-saved Disks.
GET
List Disks
Returns a paginated list of owned and active-saved Disks, optionally narrowed by scope, category, or tag.
When
search is set, current production behavior searches owned Disks only and returns a slimmer result shape.
Query parameters
string
Natural language search over owned Disks. Combines semantic embedding match with title/summary
ILIKE fallback.string
default:"all"
Library scope for non-search lists:
all, owned, saved, private, or published.string
Filter to one category id (e.g.
technology, philosophy, spirituality). Ignored when search is set.string
Filter to Disks containing this exact tag name. Applied after the search/category step.
integer
default:"20"
Page size. Capped at
100.integer
default:"0"
Pagination offset. Ignored when
search is set.Examples
Response
array
string
The effective scope. Search responses always return
owned.integer
Total matching count (best-effort; equals
disks.length for search responses).