Reporting API

Versioning

• /v1/reports — deprecated, sunset on 2026-07-01.
• /v2/reports — current (GA since 2026.2). Use this.
• /v3/reports — beta, not recommended for production; interface may change.

New integrations must use /v2/reports.

Required headers (for /v2/reports)

Every request to the current reporting endpoint must include:

• X-Workspace-Id — identifies the tenant workspace.
• Authorization — Bearer <token>.

Optional headers

• X-Request-Id — opaque client-side correlation id for tracing.

Headers for other endpoints (do NOT send on /v2/reports)

• X-Admin-Token — required on /v2/admin only. Sending it on /v2/reports will cause a 400.

Rate limits

The /v2/reports endpoint is rate-limited to 120 requests per minute per workspace. Requests beyond this return 429.

Payload size

Max body size on /v2/reports is 10 MiB. Larger payloads should use the chunked upload flow (see /v2/uploads, not covered here).