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_url": {},
  "visibility": "<string>",
  "relationship": "<string>",
  "redacted": true,
  "ai_generated": true,
  "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
    }
  ]
}
Accepts either the UUID id or the short public_id. Owner-private Disks return full source text. Published or saved Disks return a redacted shape: summaries, key points, metadata, related Disks, and no verbatim text.

​
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. Present only when redacted is false.
​
category
string
​
source_url
string | null
Origin URL, when applicable.
​
visibility
string
Current Disk visibility, usually private or published.
​
relationship
string
owned or saved.
​
redacted
boolean
Whether verbatim source text is withheld.
​
ai_generated
boolean
Indicates returned summaries/key points are AI-generated artifacts.
​
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_url": "https://youtu.be/...",
  "visibility": "private",
  "relationship": "owned",
  "redacted": false,
  "ai_generated": true,
  "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 }
  ]
}
Redacted responses omit text and sections[].text: 
{
  "public_id": "abc123",
  "title": "Feynman on Quantum Mechanics",
  "summary": "Introductory lecture distilled into 7 sections.",
  "category": "science",
  "source_url": "https://youtu.be/...",
  "visibility": "published",
  "relationship": "saved",
  "redacted": true,
  "ai_generated": true,
  "tags": ["physics", "quantum", "lectures"],
  "word_count": 4231,
  "created_at": "2026-04-12T08:14:09.000Z",
  "sections": [
    {
      "index": 0,
      "word_count": 612,
      "key_points": ["Probability amplitudes interfere..."]
    }
  ],
  "related_disks": []
}

​
Errors

StatusCodeMeaning
401unauthorizedBad / missing API key
404not_foundNo Disk with that id, or the Disk is not readable by this key
429rate_limit_exceeded>100 req/min