Quickstart - SkillDiscs

1. Generate an API key

Open Settings.
Scroll to API Keys.
Name your key (e.g. claude-agent) → Generate.
Copy the sk_... value — it is shown once.

Treat your API key like a password. Anyone holding it can read API-visible data from your SkillDiscs library. Rotate immediately if leaked.

2. Make your first request

Search your library for “quantum physics”:

curl -X POST https://skilldiscs.com/api/v1/search \
  -H "Authorization: Bearer sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"query": "quantum physics", "limit": 5}'

const res = await fetch('https://skilldiscs.com/api/v1/search', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${process.env.SKILLDISCS_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ query: 'quantum physics', limit: 5 }),
})
const { results } = await res.json()
console.log(results)

import os, requests

r = requests.post(
    "https://skilldiscs.com/api/v1/search",
    headers={"Authorization": f"Bearer {os.environ['SKILLDISCS_API_KEY']}"},
    json={"query": "quantum physics", "limit": 5},
)
print(r.json())

Response

{
  "results": [
    {
      "disk_public_id": "abc123",
      "disk_title": "Feynman on Quantum Mechanics",
      "section_index": 2,
      "snippet": "...probability amplitudes interfere...",
      "key_points": ["Probability amplitudes can reinforce or cancel each other."],
      "redacted": true,
      "similarity": 0.87
    }
  ]
}

If redacted is false, the hit includes section_text instead of snippet.

3. Read a Disk

Pass the disk_public_id from search to fetch the Disk:

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

Owner-private Disks include full text and section text. Published or saved Disks return the same Disk metadata with redacted: true and no verbatim source text.

4. Next steps

LLM Agent Integration

Connect to Claude, GPT, or custom agents.

Full API Reference

Every endpoint, parameter, response.