Skip to main content
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

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).