Using the KnotDo API

The KnotDo REST API is currently in development and will launch in Q3 2026. This guide covers the planned endpoints and authentication model so you can prepare your integration. See the API Reference for the full, up-to-date endpoint documentation.

Once the API is live, you'll generate keys from Workspace Settings → API Keys → New Key. Each key has:

• A name (for your reference)
• An optional expiry date
• Workspace-level scope (full access to your workspace)

The key is only shown once — copy and store it securely. Treat it like a password.

Pass your API key in the Authorization header:

Authorization: Bearer kd_live_xxxxxxxxxxxxxxxxxxxx

All requests must use HTTPS. The base URL is https://api.knotdo.app/v1.

The v1 API will cover:

• GET /tasks — list tasks in a workspace or list
• POST /tasks — create a task
• PATCH /tasks/:id — update a task
• DELETE /tasks/:id — delete a task
• GET /lists — list all task lists
• POST /lists — create a list
• GET /users/me — current authenticated user

Full request/response schemas are available in the API Reference.

Webhooks let KnotDo push events to your server in real time. Configure them in Workspace Settings → Webhooks → Add Webhook. Supported events:

• task.created
• task.updated
• task.completed
• task.deleted
• list.created
• list.updated

Each webhook call includes a signature in the X-KnotDo-Signature header — verify it using your webhook secret to confirm the request is from KnotDo.