Skip to content

docs: add Export All Your Data page and outbound migration section - #292

Open
tylergoerzen-mxp wants to merge 4 commits into
mainfrom
tylergoerzen/tof-686-export-data
Open

tylergoerzen-mxp wants to merge 4 commits into
mainfrom
tylergoerzen/tof-686-export-data

Conversation

@tylergoerzen-mxp

Copy link
Copy Markdown
Contributor

Why

In the AEO tracker, coding agents credit competitors with an escape hatch from lock-in. Mixpanel has no page that frames export as owning your data, and the migration guide only covers moving in. One coding agent asked for this directly: "raw event export available on the free plan, plus a published migration guide out of Mixpanel."

A source-code check confirmed that raw event export works on the current Free plan, so we can say so plainly.

What changed

  • New page docs/export-methods/export-all-data.mdx ("Export All Your Data"). It covers what you can export, a plan availability table, rate limits, data retention, a step-by-step recipe for exporting a whole project, and Data Pipelines for a continuous copy. It links to the existing API reference instead of repeating it.
  • docs.json: Export Methods becomes a nav group (root docs/export-methods) with the new page under it.
  • docs/export-methods.mdx: one-line link to the new page.
  • docs/migration.mdx: new "Moving Data Out of Mixpanel" section that links to the new page.

How facts were verified

Every claim comes from a page already in this repo or from a source-code check of the export paths:

  • Raw Event Export and Engage API work on the current Free plan; the Query API doesn't: code check. The Query API row also matches the note on Export Methods.
  • Data Pipelines is a paid add-on on Growth and Enterprise, with a 30-day trial and a 6-month backfill limit: docs/data-pipelines.mdx.
  • Rate limits (raw export 60/hr, 3/s, 100 concurrent; Engage 60/hr, 5 concurrent): reference/rate-limits.mdx, openapi/export.openapi.yaml, reference/engage-query.mdx. Code check confirmed raw export limits don't vary by plan.
  • Retention (2 years, 5 years for projects created before Sept 1, 2025): docs/privacy/gdpr-compliance.mdx.
  • Auth, servers, deduplication, timezones, identity mappings: existing reference and Data Pipelines pages.

One caveat is in the page as a note: a few projects on older Free plans don't include raw event export, and they get an error telling them so. The page points them to support.

Checks run locally: check_frontmatter.py, check_code_samples.py, check_links.py, check_redirects.py all pass. npx mint broken-links found no broken links. npx mint validate passed. docs.json parses as valid JSON.

Pricing page

The pricing page currently lists export API access as Growth and Enterprise only. That conflicts with the code for raw event export, and it's being updated separately. This PR doesn't depend on that change.

Linear

TOF-686

🤖 Generated with Claude Code

Adds a page on taking a full copy of a project (what you can export,
plan availability, rate limits, retention, and a one-pass recipe), nests
it under Export Methods in the nav, links it from Export Methods, and
adds a "Moving Data Out of Mixpanel" section to the migration guide.

TOF-686

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@mintlify

mintlify Bot commented Oct 2, 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 2, 2026, 9:47 PM

@linear-code

linear-code Bot commented Oct 2, 2026

Copy link
Copy Markdown

TOF-686

@greptile-apps

greptile-apps Bot commented Oct 2, 2026 •

Copy link
Copy Markdown
Contributor

RetriggerConfidence Score: 5/5

[Low risk] Adds documentation pages about data export.

The PR appears safe to merge; no outstanding findings remain.

Reviews (4) · Last reviewed commit: "Treat a failed move as a failed range in..."

Comment thread docs/export-methods/export-all-data.mdx Outdated
Comment thread docs/export-methods/export-all-data.mdx Outdated
The loop hardcoded data.mixpanel.com, so EU and India projects copying it
hit the wrong host. It now reads EXPORT_HOST, set in the previous step.
It also saved error bodies (such as a 429) into the .jsonl file and kept
going; --fail now stops the loop, deletes the partial file, and names the
range to retry.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Comment thread docs/export-methods/export-all-data.mdx Outdated
Comment thread docs/export-methods/export-all-data.mdx
A failed retry of a range used to delete the good file from an earlier
run, because both used the same name. Downloads now go to a temp file
that only replaces the export on success. A failed run also exited 0
after break; it now returns a failure status so scheduled jobs notice.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Comment thread docs/export-methods/export-all-data.mdx Outdated
If mv failed after a good download, the loop kept going and the run
exited 0 with that range missing. The move is now part of the same
success check, so it marks the run failed and stops.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

This branch was successfully deployed

1 active deployment
staging — bf48c914 Deployed Oct 2, 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.

1 participant