Skip to main content
GET
/
api
/
v1
/
disks
List Disks
curl --request GET \
  --url https://api.example.com/api/v1/disks
{
  "disks": [
    {
      "public_id": "<string>",
      "title": "<string>",
      "summary": "<string>",
      "category": "<string>",
      "tags": [
        "<string>"
      ],
      "word_count": 123,
      "created_at": "<string>",
      "similarity": 123
    }
  ],
  "total": 123
}

Documentation Index

Fetch the complete documentation index at: https://docs.skilldiscs.com/llms.txt

Use this file to discover all available pages before exploring further.

Returns a paginated list of your Disks, optionally narrowed by free-text search, category, or tag.

​
Query parameters

​
search
string
Natural language search. Combines semantic embedding match with title/summary ILIKE fallback.
​
category
string
Filter to one category id (e.g. technology, philosophy, spirituality). Ignored when search is set.
​
tag
string
Filter to Disks containing this exact tag name. Applied after the search/category step.
​
limit
integer
default:"20"
Page size. Capped at 100.
​
offset
integer
default:"0"
Pagination offset. Ignored when search is set.

​
Examples

# Most recent
curl https://skilldiscs.com/api/v1/disks \
  -H "Authorization: Bearer sk_your_key_here"

# Search
curl "https://skilldiscs.com/api/v1/disks?search=machine+learning" \
  -H "Authorization: Bearer sk_your_key_here"

# Filter
curl "https://skilldiscs.com/api/v1/disks?category=spirituality&tag=meditation" \
  -H "Authorization: Bearer sk_your_key_here"

​
Response

​
disks
array
​
total
integer
Total matching count (best-effort; equals disks.length for search responses).
{
  "disks": [
    {
      "public_id": "abc123",
      "title": "Feynman on Quantum Mechanics",
      "summary": "Introductory lecture distilled into 7 sections.",
      "category": "science",
      "tags": ["physics", "quantum", "lectures"],
      "word_count": 4231,
      "created_at": "2026-04-12T08:14:09.000Z"
    }
  ],
  "total": 124
}