API Reference
Every endpoint of the IForevents API, generated from the OpenAPI specification
The reference below is generated with fumadocs-openapi from the API's own OpenAPI document, so it always matches what the servers run. Each endpoint page shows the request shape, the response, code samples and a request editor you can run against your own project.
Authentication
| Caller | Header(s) | Grants |
|---|---|---|
| SDKs and browsers | X-Project-Key | Ingest only (/v1/events/*) |
| Dashboard session | Authorization: Bearer <token> | Everything, scoped to your organization and role |
| Scripts and backends | X-Project-Key + X-Project-Secret | Read-only analytics for that one project (server side only; deprecated in client code) |
Sessions are issued by the accounts service; the dashboard keeps them in httpOnly cookies. Project secrets are shown once, at creation or rotation.
Servers
| Environment | Base URL |
|---|---|
| Production | https://api.iforevents.com |
| Development | https://dev-api.iforevents.com |
| Local | http://localhost:8000 |
Sections
Browse the endpoints by area in the sidebar: health, auth, projects, team, ingest, analytics (session or project key + secret) and privacy.