Cadence API

A small, predictable REST API for your own Cadence data. Use it from scripts, integrations, or hand the generated SKILL.md to any AI assistant.

Base URL: https://cadence-ad3.pages.dev/v1 · All responses are JSON with an ok boolean. Timestamps are epoch milliseconds.

Authentication

Create a key in the app (Dashboard → API). Send it as a bearer token on every request:

Authorization: Bearer cad_live_xxxxxxxxxxxxxxxxxxxxxxxx

Keys are shown only once at creation and stored as salted hashes. Revoke instantly from the dashboard. Default scopes: records:read, records:write, analytics:read.

Data isolation & safety

Errors & rate limits

Errors return a non-2xx status and { "ok": false, "error": "...", "code": "..." }. Rate limit: 120 requests/minute per key (HTTP 429 when exceeded).

Account

Returns the account and key metadata. Use it to verify a key.

curl https://cadence-ad3.pages.dev/v1/me \
  -H "Authorization: Bearer cad_live_..."

Records

type ∈ cigarette · patch · gum · lozenge · caffeine · protein · calories. The server computes derived metrics (nicotine_mg, caffeine_mg, protein_g, calories_kcal).

curl -X POST https://cadence-ad3.pages.dev/v1/records \
  -H "Authorization: Bearer cad_live_..." \
  -H "Content-Type: application/json" \
  -d '{"type":"cigarette","quantity":1,"trigger":"coffee"}'

curl -X POST https://cadence-ad3.pages.dev/v1/records \
  -H "Authorization: Bearer cad_live_..." -H "Content-Type: application/json" \
  -d '{"type":"caffeine","quantity":1,"meta":{"source":"brewed_coffee"}}'

Analytics

Daily series + totals for your account: per-metric sums, today, last 24h, type & trigger breakdowns, goal progress.

curl "https://cadence-ad3.pages.dev/v1/analytics?range=30d" \
  -H "Authorization: Bearer cad_live_..."

Insights

The deterministic 24h / 2d / 7d trend summary with arrows, gentle flags, and correlation callouts (optionally AI-polished). Scoped to your account.

SKILL.md for AI assistants

When you create a key, Cadence generates a SKILL.md file you can download and drop into any AI assistant. It contains the software name, your key, full usage instructions, and the isolation guarantee — so an AI can safely operate only your account.