tidybird API

API Documentation

Human-friendly overview for developers. For agents and tooling, use the markdown contract.

Format: Human docs

Base URL

http://localhost:3000/api/v1

Authentication

Authorization: Bearer nk_live_xxx
# or
x-api-key: nk_live_xxx

Core endpoints

plans:read

GET /api/v1/plans/week?anchorDate=YYYY-MM-DD

plans:read

GET /api/v1/plans/:date/tasks

plans:write

POST /api/v1/plans/:date/tasks

plans:write

DELETE /api/v1/plans/:date/tasks/:taskId

inbox:read

GET /api/v1/inbox

inbox:write

POST /api/v1/inbox