Documentation
Read what will happen.
Short, exact, and honest about limits. Every route, window, and guarantee on these pages is taken from the running product — when something is a deliberate non-feature, the docs say so.
Getting started
From invitation to an active bridge: sign in with an email link, connect both accounts, and preview the exact import before activation.
Field ownershipWhat TaskBridge reads, what it writes, and what remains personal. The full boundary, field by field, including edge semantics.
Completion semanticsThe lifecycle policy: what “done” means per team, where “not done” returns an issue, and how authority is resolved when both systems disagree.
Security & OAuthPasswordless sign-in, session and CSRF protection, OAuth scopes and callbacks, and how provider tokens are encrypted, stored, and deleted.
Webhooks & reconciliationHow deliveries are verified, deduplicated, and bounded — and why reconciliation, not webhooks, is the mechanism of truth.
Quick facts
| Fact | Value |
|---|---|
| Hosted application | https://tasks.bvdm.ai — invite-only beta. |
| Sign-in | Passwordless email links. Single-use, expire in 15 minutes. |
| OAuth callbacks | /oauth/callback/linear · /oauth/callback/todoist |
| Linear webhooks | POST /webhooks/linear/<connectionId>, registered automatically per connection. |
| Todoist webhooks | POST /webhooks/todoist, app-wide, routed by Todoist user id. |
| Service health | GET /health — public, returns {"status":"ok"} after a database ping. |
| Repair pass | Per-bridge periodic reconciliation, every 5 minutes by default. |