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

# Get Disk

> Read a single Disk including sections, key points, metadata, and related Disks.

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

<ParamField path="id" type="string" required>
  Either the Disk UUID or its `public_id`.
</ParamField>

### Example

```bash theme={null}
curl https://skilldiscs.com/api/v1/disks/abc123 \
  -H "Authorization: Bearer sk_your_key_here"
```

## Response

<ResponseField name="public_id" type="string" />

<ResponseField name="title" type="string" />

<ResponseField name="summary" type="string" />

<ResponseField name="text" type="string">Full original text. Present only when `redacted` is `false`.</ResponseField>

<ResponseField name="category" type="string" />

<ResponseField name="source_url" type="string | null">Origin URL, when applicable.</ResponseField>
<ResponseField name="visibility" type="string">Current Disk visibility, usually `private` or `published`.</ResponseField>
<ResponseField name="relationship" type="string">`owned` or `saved`.</ResponseField>
<ResponseField name="redacted" type="boolean">Whether verbatim source text is withheld.</ResponseField>
<ResponseField name="ai_generated" type="boolean">Indicates returned summaries/key points are AI-generated artifacts.</ResponseField>

<ResponseField name="tags" type="string[]" />

<ResponseField name="word_count" type="integer" />

<ResponseField name="created_at" type="string" />

<ResponseField name="sections" type="array">
  <Expandable title="Section">
    <ResponseField name="index" type="integer" />

    <ResponseField name="text" type="string">Section text. Present only when `redacted` is `false`.</ResponseField>

    <ResponseField name="word_count" type="integer" />

    <ResponseField name="key_points" type="string[]">Up to 5 AI-extracted key points.</ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="related_disks" type="array">
  <Expandable title="Related disk">
    <ResponseField name="public_id" type="string" />

    <ResponseField name="title" type="string" />

    <ResponseField name="similarity" type="number" />
  </Expandable>
</ResponseField>

```json theme={null}
{
  "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`:

```json theme={null}
{
  "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

| Status | Code                  | Meaning                                                       |
| ------ | --------------------- | ------------------------------------------------------------- |
| `401`  | `unauthorized`        | Bad / missing API key                                         |
| `404`  | `not_found`           | No Disk with that id, or the Disk is not readable by this key |
| `429`  | `rate_limit_exceeded` | >100 req/min                                                  |