mocop
Browse · Docs · Guide · Analyze

Comma API

API by Comma · rest

REST API for Comma (commareports.com): publish HTML reports, edit them in place with full revision history, comment with anchors, share, attach assets, run AI reviewers, and schedule regeneration with routines, skills, and connectors. Authentication. Every endpoint (except this spec) takes a Comma personal API token as Authorization: Bearer comma_sk_…. Tokens are minted in Settings → API tokens, carry granular scopes (reports:read, reports:write, comments:read, comments:write, routines, connections, sharing; * = full access), can expire, and are revocable. Each operation below lists the scope it requires. Rate limits. Rate limit: per-token sliding window (plan-aware — Free 60 req/min, Pro 600, Team/Enterprise 6000 by default); 429 responses carry a Retry-After header. Errors. Errors are JSON: { "error": "…" } — 401 bad/missing token, 403 missing scope or no access to the resource, 404 not found (also used instead of 403 where existence must not…

Endpoint: https://commareports.com/api/v1

Verification: observed. Source: crawl.

Capabilities (53)

  • Resolve or reopen a thread
  • List replies in a thread
  • Reply to a thread
  • List connectors
  • Create a connector
  • Fetch one connector
  • Update a connector
  • Delete a connector
  • Verify a connector's credentials
  • Plan limits and AI-compute cost rails
  • Current-month routine usage + credit balance
  • List notification subscriptions
  • Create a subscription
  • Fetch one subscription
  • Update a subscription
  • Delete a subscription
  • Send a synthetic test event
  • This OpenAPI 3.1 document
  • Create a report
  • Full-text search reports
  • Fetch a report
  • Update a report in place
  • List a report's assets
  • Upload one asset
  • Remove an asset
About · Contact · Privacy