Skip to main content
POST
/
api
/
v1
/
disks
/
batch
Batch Get Disks
curl --request POST \
  --url https://api.example.com/api/v1/disks/batch \
  --header 'Content-Type: application/json' \
  --data '
{
  "ids": [
    "<string>"
  ]
}
'
{
  "disks": [
    {}
  ],
  "not_found": [
    "<string>"
  ]
}
Reduces the latency overhead of fanning out parallel requests to /disks/{id}. Current production batch retrieval is owned-only. Saved-from-others Disks are returned in not_found.

​
Request

​
ids
string[]
required
Array of Disk UUIDs or public_ids. Max 10 per call.

​
Example

curl -X POST https://skilldiscs.com/api/v1/disks/batch \
  -H "Authorization: Bearer sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"ids": ["abc123", "def456", "ghi789"]}'

​
Response

​
disks
array
Owned Disk objects with public_id, title, summary, text, category, word_count, tags, sections, and created_at. Batch responses do not include related_disks, source, or source_url.
​
not_found
string[]
IDs from the request that did not match any Disk you own.
{
  "disks": [
    {
      "public_id": "abc123",
      "title": "Feynman on Quantum Mechanics",
      "summary": "...",
      "text": "...",
      "category": "science",
      "word_count": 4231,
      "tags": ["physics"],
      "sections": [
        { "index": 0, "text": "...", "word_count": 612, "key_points": ["..."] }
      ],
      "created_at": "2026-04-12T08:14:09.000Z"
    }
  ],
  "not_found": ["ghi789"]
}

​
Errors

StatusCodeMeaning
400bad_requestids missing or not an array
400batch_too_largeMore than 10 ids — split the request
401unauthorizedBad / missing API key
429rate_limit_exceeded>100 req/min