The Turbodoc REST API

https://api.turbodoc.ai

The full, machine-readable OpenAPI specification lives at /swagger.json, with interactive documentation at /swagger.

All endpoints (except the public contact form) require a Supabase Auth JWT, sent as a bearer token:

Authorization: Bearer <your-supabase-jwt>

Tokens are issued when a user signs in to Turbodoc. If you're building an AI-assistant integration, you likely don't need to handle tokens at all — use the MCP server instead, which wraps the same functionality behind OAuth 2.0.

• /v1/bookmarks — CRUD, full-text search, batch operations (up to 100), and Open Graph metadata fetching.
• /v1/notes — markdown notes with optimistic locking, batch operations, and audio transcription.
• /v1/code-snippets — snippets with language, theme, and styling metadata.
• /v1/diagrams — canvas and Mermaid diagrams, including duplication.
• /v1/tags — most-used bookmark tags with counts.

curl -X POST https://api.turbodoc.ai/v1/bookmarks \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/article",
    "title": "An interesting article",
    "tags": "reading|ai",
    "status": "unread"
  }'

The API is a Cloudflare Worker built with Hono, and the entire codebase — API, web app, iOS app, and browser extensions — is open source at github.com/turbodoc-org. Issues and pull requests welcome.