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}'
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.
