API reference

Base URL: https://kestrel-a.docka.ai/api/v1. All endpoints require a bearer token: Authorization: Bearer <api_key>. Responses are JSON.

Getting an API key

Sign in to the dashboard, open Settings → API keys, and create a key. Keys do not expire.

Endpoints

MethodPathDescription
GET/api/v1/meThe authenticated identity: id, name, plan.
GET/api/v1/notesList notes.
POST/api/v1/notesCreate a note: {"title": "...", "body": "...", "tags": ["..."]}
GET/api/v1/notes/{id}One note.
DELETE/api/v1/notes/{id}Delete a note.

Errors

401 missing or invalid token · 403 plan limit reached · 404 unknown note · 429 slow down.

Rate limits

600 requests per minute per key.