Skip to content

Clarify event and request size limits (1 MiB / 10 MiB) and fix 413 example - #346

Merged
kurbycchua merged 4 commits into
mainfrom
claude/event-size-limit-bytes
Oct 27, 2026
Merged

kurbycchua merged 4 commits into
mainfrom
claude/event-size-limit-bytes

Conversation

@claude

@claude claude Bot commented Oct 23, 2026 •

Copy link
Copy Markdown
Contributor

Requested by Kurby Chua · Slack thread

Before: The Import Events page says /import accepts 10MB uncompressed per request, but the 413 example in the ingestion OpenAPI spec says request exceeds max limit of 2097152 bytes (2MB). The 1MB per-event limit appeared only on the API reference pages, with no note on what happens when an event is too large, and wasn't mentioned in the events and properties FAQ. The Track Event page also linked to a nonexistent #rate-limits anchor.

After: The 413 example reports request exceeds max limit of 10485760 bytes. The Track Event and Import Events pages keep the per-event limit as 1MB of uncompressed JSON and now note that larger events are rejected with a 400 error. The "What are the limits of events and properties?" FAQ now mentions the per-event size limit and links to the Track Event limits section. The Track Event link now points to /reference/import-events#rate-limit, matching the "Rate Limit" heading.

How: Limits were confirmed against Mixpanel's ingestion code: the per-event cap is 1 MiB (1,048,576 bytes) of raw JSON after gzip decompression (400 on /track and /import), and the /import request cap is 2000 events and 10 MiB (10,485,760 bytes) measured after decompression (413). The encoder's internal 2 MiB record cap is not customer-facing, which is where the old 2097152 example came from. 2097152 appeared nowhere else in the repo.

🤖 Generated with Claude Code

https://claude.ai/code/session_01WZEB62ivGnogwXg1JegNzt

…ample

- Fix /import 413 example to report the actual 10485760-byte request cap
- State exact byte limits for per-event (1,048,576) and per-request
  (10,485,760) sizes, and note over-size events get a 400
- Add per-event size limit to the events and properties FAQ
- Fix broken #rate-limits anchor on the track page

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01WZEB62ivGnogwXg1JegNzt
@mintlify

mintlify Bot commented Oct 23, 2026 •

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated
mixpanel-docs 🟢 Ready View Preview Oct 27, 2026, 8:15 AM

@greptile-apps

greptile-apps Bot commented Oct 23, 2026 •

Copy link
Copy Markdown
Contributor

RetriggerView in GreptileConfidence Score: 5/5

[Low impact] The documentation changes appear safe to merge.

Reviews (3) · Last reviewed commit: "Merge branch 'main' into claude/event-si..." · Reviewed by Greptile

@claude
claude Bot marked this pull request as ready for review October 23, 2026 00:12
@claude
claude Bot requested a review from a team as a code owner October 23, 2026 00:12
@claude
claude Bot requested a review from santigracia October 23, 2026 00:12
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01WZEB62ivGnogwXg1JegNzt

@santigracia santigracia left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM!

@kurbycchua
kurbycchua merged commit c53022f into main Oct 27, 2026
8 checks passed
@kurbycchua
kurbycchua deleted the claude/event-size-limit-bytes branch October 27, 2026 08:22

This branch was successfully deployed

1 active deployment
staging — 83d9da48 Deployed Oct 27, 2026 by mintlify[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants