Developers

The quik.md API

A capture-first API for agents, automations, scripts, and workflow tools. Send unfinished work into quik.md, or use the public docs repo to build the same inbox layer yourself.

Base URL

Production: https://quik.md. Every endpoint lives under /api/v1.

Quick start

Mint a key in Settings → Developer and send it as a Bearer token. Basic capture, list, search, toggle, archive, projects, and tags work on the free plan.

export QUIK_KEY="<QUIK_API_KEY>"

curl -X POST https://quik.md/api/v1/capture -H "Authorization: Bearer $QUIK_KEY" -H "Content-Type: application/json" -d '{"text":"buy oat milk tomorrow","type":"todo","source":"api","organize":false}'

Use quik.md as an automation inbox

quik.md works well as the final capture layer for n8n, Make.com, Claude Code, Codex, Telegram bots, cron jobs, and internal agents. Keep the workflow responsible for moving data. Keep quik responsible for durable review, search, routing, and later organization.

{
  "text": "Follow up with Mira about launch checklist\n\nSource: Slack #growth\nLink: https://example.com/source",
  "type": "todo",
  "source": "api",
  "organize": false
}

Workflow templates and public docs repo

The public docs repo now contains the OpenAPI spec, agent skills, and workflow assets. Use the templates directly, or read the self-hosted guide if you want to build a quik-like capture inbox without quik.md.

n8n workflow JSONImportable starter templates for Telegram, Gmail, weekly notes, Slack ideas, and agent fallback captures.Make.com scenario blueprintModule-by-module HTTP capture guide for quik.md or your own capture endpoint.Self-hosted automation inboxBuild the same pattern yourself with a capture API, auth, database, dedupe, review UI, logging, and backups.

Repo: github.com/egebese/quikmd-docs.

Surface area

Five resource families. Pick the one that matches your job, or jump straight to the agent prompt packs.

Plans, rate limits, idempotency

Per-user request rate limits apply to every authenticated call. Free: 60/min and 1,000/day. Pro: 300/min and 10,000/day. AI-backed routes, including capture with organize:true, voice transcription, and webhooks require Pro. For starter workflow templates, keep organize:false until the delivery path is reliable.

The 429 response carries Retry-After and a retry_after JSON field. Item create accepts an optional id UUID so retries do not duplicate. Full table on Authentication.

OpenAPI

A hand-authored OpenAPI 3.1 spec is published at /docs/api/openapi.json and mirrored in quikmd-docs/openapi.json. Point your client generator at either one.