clawhub/docs/api.md

summary	read_when
Public REST API (v1) overview and conventions.	Building API clients Adding endpoints or schemas

API v1

Base: https://clawdhub.com

OpenAPI: /api/v1/openapi.json

Auth

• Public read: no token required.
• Write + account: Authorization: Bearer clh_....

Rate limits

Per IP + per API key:

• Read: 120/min per IP, 600/min per key
• Write: 30/min per IP, 120/min per key

Headers: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset, Retry-After (on 429).

Endpoints

Public read:

• GET /api/v1/search?q=...
• GET /api/v1/skills?limit=&cursor=
• GET /api/v1/skills/{slug}
• GET /api/v1/skills/{slug}/versions?limit=&cursor=
• GET /api/v1/skills/{slug}/versions/{version}
• GET /api/v1/skills/{slug}/file?path=&version=&tag=
• GET /api/v1/resolve?slug=&hash=
• GET /api/v1/download?slug=&version=&tag=

Auth required:

• POST /api/v1/skills (publish, multipart preferred)
• DELETE /api/v1/skills/{slug}
• POST /api/v1/skills/{slug}/undelete
• GET /api/v1/whoami

Legacy

Legacy /api/* and /api/cli/* still available. See DEPRECATIONS.md.