Public developer reference

Annotate API

Use the widget ingest API for customer reports and the authenticated dashboard APIs for report workflows, projects, teams, and GitHub integrations.

Download OpenAPI JSON · Security and data handling

Authentication

Widget ingest
POST /reports uses the project api_key in JSON. It is intentionally public and rate limited per key.

Dashboard API
Use Authorization: Bearer <jwt> from /auth/login or /auth/register.

Widget report example

POST /reports
{
  "api_key": "pk_live_...",
  "type": "bug",
  "priority": "high",
  "comment": "Checkout button stopped responding",
  "page_url": "https://app.example.com/checkout",
  "environment": {
    "browser": "Chrome",
    "browser_version": "147",
    "os": "macOS",
    "os_version": "15",
    "viewport_width": 1440,
    "viewport_height": 900
  },
  "console_entries": [],
  "network_entries": []
}

Core endpoints

Endpoint	Purpose
`GET /health`	API and database health.
`POST /auth/register`	Create account; invite token supported.
`POST /auth/login`	Get dashboard JWT.
`POST /reports`	Ingest public widget report.
`GET /reports`	Authenticated, filtered report list.
`GET /reports/export.csv`	Formula-safe CSV export.
`POST /reports/{id}/create-issue`	Create GitHub Issue from a report.
`POST /reports/{id}/create-pr`	Create AI-generated GitHub PR. Pro required.