Skip to main content
GET
/
api
/
v1
/
disks
/
{id}
Get Disk
curl --request GET \
  --url https://api.example.com/api/v1/disks/{id}
{
  "public_id": "<string>",
  "title": "<string>",
  "summary": "<string>",
  "text": "<string>",
  "category": "<string>",
  "source": "<string>",
  "source_url": "<string>",
  "tags": [
    "<string>"
  ],
  "word_count": 123,
  "created_at": "<string>",
  "sections": [
    {
      "index": 123,
      "text": "<string>",
      "word_count": 123,
      "key_points": [
        "<string>"
      ]
    }
  ],
  "related_disks": [
    {
      "public_id": "<string>",
      "title": "<string>",
      "similarity": 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.

Accepts either the UUID id or the short public_id.

​
Path parameters

​
id
string
required
Either the Disk UUID or its public_id.

​
Example

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

​
Response

​
public_id
string
​
title
string
​
summary
string
​
text
string
Full original text.
​
category
string
​
source
string
text | pdf | youtube | url.
​
source_url
string
Origin URL, when applicable.
​
tags
string[]
​
word_count
integer
​
created_at
string
​
sections
array
​
related_disks
array
{
  "public_id": "abc123",
  "title": "Feynman on Quantum Mechanics",
  "summary": "Introductory lecture distilled into 7 sections.",
  "text": "...",
  "category": "science",
  "source": "youtube",
  "source_url": "https://youtu.be/...",
  "tags": ["physics", "quantum", "lectures"],
  "word_count": 4231,
  "created_at": "2026-04-12T08:14:09.000Z",
  "sections": [
    {
      "index": 0,
      "text": "...",
      "word_count": 612,
      "key_points": ["Probability amplitudes interfere..."]
    }
  ],
  "related_disks": [
    { "public_id": "def456", "title": "Schrödinger's Cat — Explained", "similarity": 0.74 }
  ]
}

​
Errors

StatusCodeMeaning
401unauthorizedBad / missing API key
404not_foundNo Disk with that id, or you don’t own it
429rate_limit_exceeded>100 req/min