Skip to main content
Untitled Analytics has two public interfaces: the event collector, which takes events with the publishable key or the secret key, and the MCP server, which reads reports with an API key or an OAuth token. Untitled Analytics also sends outgoing requests to you: alert webhooks, signed with a per-alert secret.
The dashboard uses a private API for reports, dashboards and settings. It is not a public API and can change without notice. To read reports or change dashboards from your own tools, use the MCP server.

Base URL

Use the collector endpoint shown on your project’s setup page, for example https://YOUR_COLLECTOR_ENDPOINT. Behind a reverse proxy, browser events can use your own domain instead.

Keys

  • Publishable key: one per project. Safe to ship in a page or a game build. It sends website and game events, and nothing else. For a browser, the collector also checks that the origin is your project domain or an allowed origin, and that each web page URL is on your project domain.
  • Secret key: one per project, for your backend only. It sends server events, and nothing else.
  • API key: secret, read-only by default, with scopes. It reads and manages through the REST API and the MCP server. A project can have several. Each can be revoked.
Never put a secret key or an API key in browser, mobile or game code. See authentication.

Errors

Errors return JSON with a code and a message:
See errors for every code and which ones to retry.

Retries

Each event has a message_id. Reports count each message_id once, so a retry with the same ID does not count twice. See idempotency.

Rate limits

  • Events: each project has a per-minute event limit that is far above normal traffic. It stops an abused key from flooding the collector. Server events have their own limit, so browser traffic does not use up the quota of your backend. Over the limit, the collector returns 429 RATE_LIMITED with a Retry-After header. Each request is also limited by batch size.
  • MCP: per-key and per-workspace limits. See MCP limits.