REST API Reference
Complete reference for KorClaw API v1 endpoints.
Base URL
text
https://app.korclaw.com/api/v1Authentication
All endpoints except GET /health require Authorization: Bearer <api_key>. Runtime endpoints accept optional X-KorClaw-Agent-Key.
Response envelope
json
// Success: { "data": <T> }
// Error: { "error": { "code": "...", "message": "..." } }
// Paginated: { "data": [...], "has_more": true, "next_cursor": "..." }Response headers
- X-Request-Id — UUID per request
- X-Response-Time — e.g. 42ms
- X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset
- Retry-After — on 429 responses