REST API

HTTP + JSON access to the SkillzDrive catalog, drives, collections, uploads, and executions. Use from any language that can speak HTTP — no MCP client required.

Base URL

Every endpoint below is prefixed by this base URL. Responses are JSON. Errors follow a consistent envelope (see below).

Authentication

Most endpoints require a SkillzDrive API key. Pass it as a Bearer token:

Authorization: Bearer sk_live_<your-key>

Create keys in the Account dashboard. Keys come in two flavors:

Anonymous access

A few public read endpoints work without any key — handy for discovery-only clients. Anonymous requests are rate-limited to 1 request per minute per IP and should include an install-id header for soft identity:

X-Skillzdrive-Install-Id: <a-uuid-you-generate-once>

Anonymous-capable endpoints are marked Anonymous: ✓ in the Endpoints reference.

Response shape

Successful responses carry a data key. Errors carry an error object with a stable machine code and a human-readable message.

{
  "data": {
    "collections": [
      { "name": "default", "scope": "all_skills", "skillCount": "all" },
      { "name": "acme-team", "scope": "scoped", "skillCount": 12 }
    ],
    "count": 2
  }
}

HTTP status codes

Your first call

Search the public catalog anonymously — zero signup required:

curl -H "X-Skillzdrive-Install-Id: $(uuidgen)" \
     "https://www.skillzdrive.com/api/v1/skills?q=weather"

List the collections on your account (authenticated):

curl -H "Authorization: Bearer sk_live_..." \
     "https://www.skillzdrive.com/api/v1/collections"

Keep reading