ManaLens 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 examplehttps://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.
Errors
Errors return JSON with a code and a message:Retries
Each event has amessage_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
429RATE_LIMITEDwith aRetry-Afterheader. Each request is also limited by batch size. - MCP: per-key and per-workspace limits. See MCP limits.