Skip to main content

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.

Base URL

https://skilldiscs.com/api/v1

Endpoints

MethodPathPurpose
POST/searchSemantic search across all your Disks
GET/disksList & filter your Disks
GET/disks/{id}Read one Disk (UUID or public_id)
POST/disks/batchRead up to 10 Disks in one call

Identifiers

Disks have two identifiers:
  • id — internal UUID (e.g. f47ac10b-58cc-4372-a567-0e02b2c3d479).
  • public_id — short URL-safe slug (e.g. abc123).
Endpoints accepting {id} accept either form.

Response shape

All responses are JSON. Errors follow this shape:
{
  "error": "rate_limit_exceeded",
  "message": "Optional human description",
  "retry_after": 42
}

CORS

CORS is enabled. Browser clients on any origin can call the API directly — but never embed your API key in a client-side bundle. Proxy through your own backend.