Skip to content

docs(api): add capture v1 API reference - #21385

Open
eli-r-ph wants to merge 93 commits into
sdk-markdown-reference-js-navfrom
eli/capture-v1-api-reference
Open

eli-r-ph wants to merge 93 commits into
sdk-markdown-reference-js-navfrom
eli/capture-v1-api-reference

Conversation

@eli-r-ph

@eli-r-ph eli-r-ph commented Oct 19, 2026 •

Copy link
Copy Markdown
Contributor

⚠️ DO NOT MERGE prior to v1 SDK public release! ⚠️

Summary

This PR adds a reference page for capture v1, the new event capture API. The page describes the two endpoints, the required headers, the request and event format, event options, compression, limits, status codes, per-event results, retries, and clock skew. Legacy capture stays documented and supported.

This is the first PR of three. Do not merge before the first capture v1 SDK release.

Changes

  • New page /docs/api/capture-v1, with a nav entry under API after "Capture".
  • A "Library name and version" section: PostHog stores the $lib/$lib_version an event sends and fills them from PostHog-Sdk-Info only when $lib is missing. The capture v1 SDK page and the Go, Python and Rust MCP analytics pages match.
  • A redirect from /docs/billing/limits to /docs/billing/limits-alerts. Capture v1 links to /docs/billing/limits in its 402 response, and that path returns 404 today.

Open items

Checks

  • markdownlint: no errors.
  • Vale 3.13.1: no new findings, except for rule matches on the general words "endpoints" and "logs".
  • Prettier: src/navs/index.js and vercel.json pass.
  • Nav screenshots below; console errors unchanged.

Screenshots: API nav

State Before After
Light, wide before-api-nav-light-wide after-api-nav-light-wide
Dark, wide before-api-nav-dark-wide after-api-nav-dark-wide
Light, narrow before-api-nav-light-narrow after-api-nav-light-narrow
Dark, narrow before-api-nav-dark-narrow after-api-nav-dark-narrow

At narrow widths the site collapses the sidebar, so the narrow shots show the page itself. Console: the same errors appear on production and on the preview of an unchanged page, so this PR adds none.


Review the stack together

This PR is stacked on #22061, the nav PR for the Markdown SDK references. Merge #22061 first, then this PR. The deploy preview of this PR has the changes from both PRs, so you can review every page there.

What each PR changes

  • [Waiting on SDK releases] feat(docs): replace the SDK pages with their Markdown references #22061: The docs nav links the Markdown reference for Python, JavaScript Web, Node.js, React Native, Go, Rust, iOS, Android, and Flutter. Old /docs/references/posthog-* URLs redirect to the new pages. The error tracking reference links go to the new pages.
  • This PR: The capture v1 API page and the capture v1 changes across the docs. This PR also adds these changes:
    • "SDK comparison" (/docs/libraries) is now "Choosing a PostHog SDK". The page has the same URL. A table at the top shows the SDK versions that use capture v1, with a link to each migration guide. The feature comparison is below the table.
    • The Python, Go, Rust, Node.js, iOS, Android, and Flutter pages start with a callout. The callout gives the first version that uses capture v1, and links to the migration guide and to the reference for the older version.
    • There is no "Upgrading to capture v1" page. Each SDK has its own migration guide. /docs/libraries/capture-v1 redirects to /docs/libraries, because the generated migration guides link to it.
    • The legacy capture page and the capture v1 page show the same "New capture API" callout, from one snippet.
    • In the SDK nav, "SDK bootstrapping" moves to the end of the list.

Pages to check

Nav and reference pages (#22061). Use the SDKs section of the docs nav. Each SDK has a "Reference" page with a page for each major version. The SDKs that move to capture v1 also have a "Migration" page.

  • Python: /docs/libraries/python/reference, /7.x.x, /8.x.x, /migration
  • Go: /docs/libraries/go/reference, /1.x.x, /2.x.x, /migration
  • Rust: /docs/libraries/rust/reference, /0.x.x, /1.x.x, /migration
  • iOS: /docs/libraries/ios/reference, /3.x.x, /4.x.x, /migration
  • Android: /docs/libraries/android/reference, /3.x.x, /4.x.x, /migration
  • Flutter: /docs/libraries/flutter/reference, /5.x.x, /6.x.x, /migration
  • Node.js: /docs/libraries/node/reference, /5.x.x, /6.x.x (no migration page yet, so the links go to MIGRATION.md on GitHub)
  • JavaScript Web: /docs/libraries/js/reference, /1.x.x
  • React Native: /docs/libraries/react-native/reference, /4.x.x
  • Error tracking: /docs/error-tracking/references

Pages that this PR changes (117 files):

SDK pages (20)
  • /docs/libraries
  • /docs/libraries/android
  • /docs/libraries/cloudflare-workers
  • /docs/libraries/django
  • /docs/libraries/fastify
  • /docs/libraries/flask
  • /docs/libraries/flutter
  • /docs/libraries/go
  • /docs/libraries/hono
  • /docs/libraries/ios/configuration
  • /docs/libraries/ios
  • /docs/libraries/ios/usage
  • /docs/libraries/nestjs
  • /docs/libraries/node
  • /docs/libraries/python
  • /docs/libraries/react-router/react-router-v7-framework-mode
  • /docs/libraries/rust
  • /docs/libraries/svelte
  • /docs/libraries/tanstack-start
  • /docs/libraries/vercel
API (3)
  • /docs/api/capture-v1
  • /docs/api/capture
  • /docs/api
MCP analytics (10)
  • /docs/mcp-analytics/custom-events
  • /docs/mcp-analytics/events
  • /docs/mcp-analytics/identifying-users
  • /docs/mcp-analytics/installation/go
  • /docs/mcp-analytics/installation/other-languages
  • /docs/mcp-analytics/installation/python
  • /docs/mcp-analytics/installation/rust
  • /docs/mcp-analytics/installation/typescript
  • /docs/mcp-analytics/privacy
  • /docs/mcp-analytics/start-here
AI observability and evals (5)
  • /docs/ai-evals/offline-evals
  • /docs/ai-observability/basics
  • /docs/ai-observability/custom-properties
  • /docs/ai-observability/installation/manual-capture
  • /docs/ai-observability/large-events
Other docs (29)
  • /docs/data/events
  • /docs/data/ingestion-warnings
  • /docs/data/timestamps
  • /docs/distributed-tracing/installation/go
  • /docs/distributed-tracing/installation/python
  • /docs/error-tracking/capture
  • /docs/error-tracking/installation/go
  • /docs/error-tracking/installation/nestjs
  • /docs/error-tracking/installation/rust
  • /docs/error-tracking/link-releases/python
  • /docs/experiments/installation/rust
  • /docs/feature-flags/installation/openfeature-js
  • /docs/feature-flags/local-evaluation
  • /docs/health-checks/keeping-sdks-current
  • /docs/how-posthog-works/ingestion-pipeline
  • /docs/metrics/installation/nodejs
  • /docs/metrics/installation/python
  • /docs/migrate
  • /docs/product-analytics/group-analytics
  • /docs/product-analytics/identify
  • /docs/product-analytics/identity-resolution
  • /docs/product-analytics/schema-management
  • /docs/self-host/configure/running-behind-proxy
  • /docs/self-host
  • /docs/web-analytics/bot-detection
  • /docs/workflows/transactional-emails/go
  • /docs/workflows/transactional-emails/node
  • /docs/workflows/transactional-emails/python
  • /docs/workflows/transactional-emails/rust
Snippets (shown on other pages) (14)
  • contents/docs/_snippets/python-sdk-version-note.mdx – shows on /docs/libraries/python, /docs/libraries/django, /docs/libraries/flask
  • contents/docs/api/_snippets/capture-v1-callout.mdx – shows on /docs/api/capture, /docs/api/capture-v1
  • contents/docs/data-pipelines/_snippets/persons-model-note.mdx
  • contents/docs/feature-flags/snippets/groups-ingestion-go.mdx
  • contents/docs/getting-started/_snippets/user-properties-how-to-set.mdx
  • contents/docs/integrate/_snippets/configure-secret-api-key.mdx
  • contents/docs/integrate/_snippets/install-go.mdx
  • contents/docs/integrate/_snippets/install-node-package-managers.mdx
  • contents/docs/integrate/_snippets/install-python.mdx
  • contents/docs/integrate/_snippets/install-rust.mdx
  • contents/docs/integrate/feature-flags-code/_snippets/feature-flags-code-go.mdx
  • contents/docs/integrate/feature-flags-code/_snippets/feature-flags-code-rust.mdx
  • contents/docs/integrate/send-events/_snippets/send-events-rust.mdx
  • contents/docs/product-analytics/_snippets/how-to-capture-anonymous-backend-and-api.mdx – shows on /docs/product-analytics/capture-events, /docs/data/anonymous-vs-identified-events
Tutorials (34)
  • /tutorials/anthropic-analytics
  • /tutorials/astro-ab-tests
  • /tutorials/astro-analytics
  • /tutorials/bootstrap-feature-flags-react
  • /tutorials/cohere-analytics
  • /tutorials/django-ab-tests
  • /tutorials/django-analytics
  • /tutorials/event-tracking-guide
  • /tutorials/go-ab-tests
  • /tutorials/go-analytics
  • /tutorials/go-feature-flags
  • /tutorials/llm-ab-tests
  • /tutorials/mcp-analytics
  • /tutorials/nextjs-ab-tests
  • /tutorials/nextjs-analytics
  • /tutorials/nextjs-error-monitoring
  • /tutorials/nextjs-pages-analytics
  • /tutorials/node-express-ab-tests
  • /tutorials/node-express-analytics
  • /tutorials/nuxt-analytics
  • /tutorials/nuxt-feature-flags
  • /tutorials/nuxtjs-ab-tests
  • /tutorials/one-time-feature-flags
  • /tutorials/openai-observability
  • /tutorials/openrouter-observability
  • /tutorials/python-ab-testing
  • /tutorials/python-analytics
  • /tutorials/python-error-tracking
  • /tutorials/python-feature-flags
  • /tutorials/remix-ab-tests
  • /tutorials/remix-analytics
  • /tutorials/rust-analytics
  • /tutorials/svelte-ab-tests
  • /tutorials/track-high-volume-apis
Handbook (1)
  • /handbook/wizard-and-docs/wizard-edge-cases
Other files (1)
  • contents/docs/product-analytics/installation/api.eval.yaml

🤖 Generated with Claude Code

@github-actions github-actions Bot added the docs Improvements or additions to product documentation, "Docs" label Oct 19, 2026
@github-actions

github-actions Bot commented Oct 19, 2026 •

Copy link
Copy Markdown
Contributor

Deploy preview

Status Details Updated (UTC)
🟢 Ready View preview Nov 15, 2026 09:05PM

Changed pages

Page Source
Self-hosted proxy reference contents/docs/advanced/proxy/proxy-reference.mdx
Offline evals contents/docs/ai-evals/offline-evals.mdx
AI Observability basics contents/docs/ai-observability/basics.mdx
Custom properties contents/docs/ai-observability/custom-properties.mdx
Manual capture AI Observability installation contents/docs/ai-observability/installation/manual-capture.mdx
Capturing large AI events contents/docs/ai-observability/large-events.mdx
Link error tracking contents/docs/ai-observability/link-error-tracking.mdx
API overview contents/docs/api/index.mdx
Capture and batch API endpoints contents/docs/api/capture.mdx
Capture API (v1) contents/docs/api/capture-v1.mdx
Linking crates.io as a source contents/docs/data-pipelines/sources/crates-io.md
Events contents/docs/data/events.mdx
Ingestion warnings contents/docs/data/ingestion-warnings.mdx
Timestamps contents/docs/data/timestamps.md
Go tracing installation contents/docs/distributed-tracing/installation/go.mdx
Python tracing installation contents/docs/distributed-tracing/installation/python.mdx
Capture exceptions for error tracking contents/docs/error-tracking/capture.mdx
Go Error Tracking installation contents/docs/error-tracking/installation/go.mdx
NestJS Error Tracking installation contents/docs/error-tracking/installation/nestjs.mdx
Rust Error Tracking installation contents/docs/error-tracking/installation/rust.mdx
Link releases for Python contents/docs/error-tracking/link-releases/python.mdx
Rust Experiments installation contents/docs/experiments/installation/rust.mdx
OpenFeature (JavaScript) contents/docs/feature-flags/installation/openfeature-js.mdx
Server-side local evaluation contents/docs/feature-flags/local-evaluation/index.mdx
Keeping SDKs current contents/docs/health-checks/keeping-sdks-current.mdx

72 more changed pages are not listed.

@github-actions

github-actions Bot commented Oct 19, 2026 •

Copy link
Copy Markdown
Contributor

Vale prose linter → found 68 errors, 1556 warnings, 70 suggestions in your markdown

Full report → · Copy the Job Summary code block into an LLM to batch-fix issues.

Note: Too many findings to show inline. See the Job Summary linked above.

File Errors Warnings Suggestions
contents/blog/google-analytics-to-posthog.md 2 9 0
contents/docs/_snippets/identify-cross-platform.mdx 0 2 3
contents/docs/_snippets/identify-intro.mdx 1 0 0
contents/docs/_snippets/python-sdk-version-note.mdx 0 3 0
contents/docs/advanced/content-security-policy.md 1 9 0
contents/docs/advanced/proxy/proxy-reference.mdx 0 13 0
contents/docs/ai-evals/offline-evals.mdx 0 11 0
contents/docs/ai-observability/basics.mdx 0 3 0
contents/docs/ai-observability/custom-properties.mdx 0 7 0
contents/docs/ai-observability/installation/manual-capture.mdx 0 2 0
contents/docs/ai-observability/large-events.mdx 0 17 0
contents/docs/ai-observability/link-error-tracking.mdx 0 6 0
contents/docs/api/_snippets/capture-v1-callout.mdx 0 2 0
contents/docs/api/capture-v1.mdx 0 9 0
contents/docs/api/capture.mdx 0 5 0
contents/docs/api/index.mdx 0 23 3
contents/docs/data-pipelines/sources/crates-io.md 0 1 0
contents/docs/data/events.mdx 1 5 0
contents/docs/data/ingestion-warnings.mdx 1 36 0
contents/docs/data/timestamps.md 0 1 0
contents/docs/distributed-tracing/installation/dotnet.mdx 0 2 0
contents/docs/distributed-tracing/installation/nodejs.mdx 0 2 0
contents/docs/distributed-tracing/installation/php.mdx 0 1 0
contents/docs/distributed-tracing/installation/python.mdx 0 2 0
contents/docs/error-tracking/capture.mdx 0 5 1
contents/docs/error-tracking/grouping-issues.mdx 0 2 0
contents/docs/error-tracking/installation/elixir.mdx 0 2 1
contents/docs/error-tracking/installation/go.mdx 0 4 0
contents/docs/error-tracking/installation/nestjs.mdx 0 1 0
contents/docs/error-tracking/installation/python.mdx 0 3 0
contents/docs/error-tracking/installation/rust.mdx 5 9 0
contents/docs/error-tracking/link-releases/python.mdx 0 1 0
contents/docs/error-tracking/references.mdx 0 4 0
contents/docs/experiments/installation/rust.mdx 0 0 2
contents/docs/feature-flags/cutting-costs.mdx 0 23 0
contents/docs/feature-flags/early-access-feature-management.mdx 0 6 0
contents/docs/feature-flags/evaluation-contexts.mdx 0 10 0
contents/docs/feature-flags/installation/openfeature-js.mdx 5 1 3
contents/docs/feature-flags/local-evaluation/index.mdx 5 6 0
contents/docs/feature-flags/snippets/groups-ingestion-go.mdx 0 1 0
contents/docs/feature-flags/surfaces/web-app.mdx 0 7 1
contents/docs/feature-flags/troubleshooting.mdx 0 28 3
contents/docs/getting-started/_snippets/user-properties-how-to-set.mdx 1 0 0
contents/docs/health-checks/keeping-sdks-current.mdx 0 12 0
contents/docs/how-posthog-works/ingestion-pipeline.mdx 4 4 1
contents/docs/integrate/feature-flags-code/_snippets/feature-flags-code-go.mdx 0 7 2
contents/docs/integrate/feature-flags-code/_snippets/feature-flags-code-rust.mdx 0 4 2
contents/docs/libraries.mdx 1 0 0
contents/docs/libraries/cloudflare-workers.mdx 3 11 0
contents/docs/libraries/django.mdx 1 6 0
contents/docs/libraries/dotnet/index.mdx 1 14 0
contents/docs/libraries/elixir/index.mdx 0 10 0
contents/docs/libraries/fastify.mdx 0 10 0
contents/docs/libraries/flask.mdx 1 7 0
contents/docs/libraries/hono.mdx 0 7 0
contents/docs/libraries/java/index.mdx 0 13 0
contents/docs/libraries/laravel.md 0 15 0
contents/docs/libraries/nestjs.mdx 0 2 1
contents/docs/libraries/nuxt-js-3-6.mdx 0 10 0
contents/docs/libraries/php/index.mdx 0 27 1
contents/docs/libraries/python/_snippets/contexts.mdx 0 2 1
contents/docs/libraries/python/_snippets/django-context-middleware.mdx 0 3 3
contents/docs/libraries/react-native/index.mdx 0 46 10
contents/docs/libraries/react-router/react-router-v7-framework-mode.mdx 0 3 0
contents/docs/libraries/ruby-on-rails.mdx 0 22 2
contents/docs/libraries/segment.md 1 11 2
contents/docs/libraries/svelte.mdx 0 12 0
contents/docs/libraries/tanstack-start.mdx 2 3 1
contents/docs/libraries/vercel.mdx 0 7 0
contents/docs/logs/installation/javascript.mdx 0 8 2
contents/docs/mcp-analytics/custom-events.mdx 0 2 0
contents/docs/mcp-analytics/events.mdx 0 13 1
contents/docs/mcp-analytics/identifying-users.mdx 0 3 2
contents/docs/mcp-analytics/installation/go.mdx 0 10 0
contents/docs/mcp-analytics/installation/other-languages.mdx 0 1 1
contents/docs/mcp-analytics/installation/python.mdx 0 11 0
contents/docs/mcp-analytics/installation/rust.mdx 0 14 1
contents/docs/mcp-analytics/installation/typescript.mdx 0 5 0
contents/docs/mcp-analytics/installation/webmcp.mdx 0 1 0
contents/docs/mcp-analytics/privacy.mdx 0 5 0
contents/docs/mcp-analytics/start-here.mdx 0 0 2
contents/docs/metrics/installation/javascript.mdx 1 5 0
contents/docs/metrics/installation/nodejs.mdx 1 4 0
contents/docs/metrics/installation/python.mdx 1 3 0
contents/docs/migrate/google-analytics.mdx 0 4 0
contents/docs/migrate/heap.mdx 0 2 0
contents/docs/migrate/index.mdx 0 1 0
contents/docs/migrate/matomo.mdx 0 1 0
contents/docs/migrate/pendo.mdx 0 2 0
contents/docs/migrate/statsig.mdx 4 13 0
contents/docs/product-analytics/_snippets/how-to-capture-identified-events-frontend.mdx 0 1 2
contents/docs/product-analytics/autocapture.mdx 0 37 3
contents/docs/product-analytics/identity-resolution.mdx 0 7 0
contents/docs/product-analytics/schema-management.mdx 1 9 0
contents/docs/self-host/configure/running-behind-proxy.md 0 12 0
contents/docs/self-host/index.mdx 0 8 0
contents/docs/session-replay/_snippets/web-installation.mdx 0 0 1
contents/docs/settings/projects.mdx 3 8 1
contents/docs/surveys/troubleshooting.mdx 2 27 2
contents/docs/web-analytics/bot-detection.mdx 0 16 6
contents/docs/web-analytics/web-vitals.mdx 8 9 0
contents/docs/workflows/transactional-emails/go.mdx 0 1 0
contents/docs/workflows/transactional-emails/node.mdx 0 1 0
contents/docs/workflows/transactional-emails/python.mdx 0 1 0
contents/docs/workflows/transactional-emails/rust.mdx 0 3 0
contents/handbook/customer-success/health-checks.md 1 22 0
contents/handbook/growth/sales/risk-mitigation-and-churn-prevention.md 2 20 0
contents/handbook/support/customer-support.md 8 20 2
contents/handbook/wizard-and-docs/wizard-edge-cases.mdx 0 423 0
contents/tutorials/angular-ab-tests.md 0 2 0
contents/tutorials/anthropic-analytics.md 0 1 0
contents/tutorials/astro-ab-tests.md 0 3 0
contents/tutorials/astro-analytics.md 0 13 0
contents/tutorials/bootstrap-feature-flags-react.md 0 16 0
contents/tutorials/cohere-analytics.md 0 1 0
contents/tutorials/cross-domain-tracking.md 0 3 0
contents/tutorials/django-ab-tests.md 0 2 0
contents/tutorials/django-analytics.md 0 14 0
contents/tutorials/event-tracking-guide.md 0 3 0
contents/tutorials/framer-analytics.md 0 6 0
contents/tutorials/go-ab-tests.md 0 2 0
contents/tutorials/go-analytics.md 0 3 0
contents/tutorials/go-feature-flags.md 0 5 0
contents/tutorials/identifying-users-guide.md 0 1 1
contents/tutorials/intercom-session-replays.md 0 11 0
contents/tutorials/llm-ab-tests.md 0 24 0
contents/tutorials/mcp-analytics.mdx 0 19 0
contents/tutorials/new-user-experiments.md 0 16 0
contents/tutorials/nextjs-ab-tests.md 0 4 0
contents/tutorials/nextjs-analytics.md 0 9 0
contents/tutorials/nextjs-error-monitoring.md 0 3 0
contents/tutorials/nextjs-pages-analytics.md 0 19 0
contents/tutorials/node-express-ab-tests.md 0 2 0
contents/tutorials/node-express-analytics.md 0 9 0
contents/tutorials/nuxt-analytics.md 0 3 0
contents/tutorials/nuxt-feature-flags.md 0 5 0
contents/tutorials/nuxtjs-ab-tests.md 0 5 0
contents/tutorials/one-time-feature-flags.md 0 7 0
contents/tutorials/openai-observability.md 0 1 0
contents/tutorials/openrouter-observability.md 0 1 0
contents/tutorials/python-ab-testing.md 0 3 0
contents/tutorials/python-analytics.md 0 3 0
contents/tutorials/python-error-tracking.md 0 5 0
contents/tutorials/python-feature-flags.md 0 5 0
contents/tutorials/python-v6-migration.md 0 7 0
contents/tutorials/remix-ab-tests.md 0 3 0
contents/tutorials/remix-analytics.md 0 8 0
contents/tutorials/ruby-on-rails-ab-tests.md 0 2 0
contents/tutorials/rust-analytics.md 0 2 0
contents/tutorials/svelte-ab-tests.md 0 2 0
contents/tutorials/track-high-volume-apis.md 0 6 0
contents/tutorials/web-redact-properties.md 0 5 0
contents/tutorials/zendesk-session-replays.md 0 7 0

@github-actions

github-actions Bot commented Oct 19, 2026 •

Copy link
Copy Markdown
Contributor

Bundle report

Total JS (gzip)

12.07 MiB (-156.9 KiB / -1.3%)

Largest changed named chunks
Chunk Gzip Δ vs master
96de664570b44467a6d0591760da6319c7a1ad80.js 127.0 KiB new
43af5110865685afc312d725bbc8b0fa06295ef4.js 48.3 KiB new
e7657ff7b4d9f20436d43a02b14e1f3e008b9586.js 24.0 KiB new
92e0c1085e591e90091fbb7fb7da7962902ac68a.js 16.3 KiB new
c398b08c5fd6725ed4539ebfc25732567896556b.js 9.7 KiB new
d53be7e4323c811b7b208da3a1f00becabbdd275.js 445.3 KiB -9.4 KiB / -2.1%
9039878e5ed83c4a38ea8b069f877637312976e8.js 7.0 KiB new
03fab9b00f7efe583e1063371bd2b772f4153aac.js 6.2 KiB new
84e1d9b7a53408f0d162750d609e4636eef2cf57.js 5.1 KiB new
app.js 1125.7 KiB -5.0 KiB / -0.4%
fc282451d0fa3a55e4c01cdb73d7ad923ec6b50c.js 4.8 KiB new
c90d25f57c4d21271dd5e4de053750c1158fe334.js 4.3 KiB new
177609198ba68da49069d791a929a1c196c544dd.js 4.0 KiB new
component---src-templates-ui-library-docs-tsx.js 327.9 KiB +2.6 KiB / +0.8%
component---src-pages-r-observability-tsx.js 10.0 KiB +1.7 KiB / +20.4%

Eager graph (modules shipped in each entrypoint's initial chunks)

Entrypoint Eager size Budget Modules
✅ app 10.41 MiB (-758.8 KiB / -6.6%) report-only 1100
Largest modules in the app closure
Module Size
css ./node_modules/.pnpm/css-loader@5.2.7_webpack@5.101.3/node_modules/css-loader/dist/cjs.js??ruleSet[1].rules[8].oneOf[1].use[1]!./node_modules/.pnpm/postcss-loader@4.3.0_postcss@8.5.6_webpack@5.101.3/node_modules/postcss-loader/dist/cjs.js??ruleSet[1].rules[8].oneOf[1].use[2]!./src/styles/global.css 1022.3 KiB
./src/components/Stickers/Stickers.tsx 696.4 KiB
./node_modules/.pnpm/@posthog+icons@0.36.6_react-dom@18.3.1_react@18.3.1__react@18.3.1/node_modules/@posthog/icons/dist/posthog-icons.es.js 354.8 KiB
./node_modules/.pnpm/react-markdown@8.0.7_@types+react@16.14.66_react@18.3.1/node_modules/react-markdown/lib/react-markdown.js + 88 modules 351.4 KiB
./node_modules/.pnpm/framer-motion@14.0.0_react-dom@18.3.1_react@18.3.1__react@18.3.1/node_modules/framer-motion/dist/es/render/components/motion/proxy.mjs + 126 modules 287.2 KiB
./node_modules/.pnpm/cloudinary-core@2.14.0_lodash@4.17.21/node_modules/cloudinary-core/cloudinary-core.js 281.9 KiB
./src/components/SearchUI/index.tsx + 87 modules 273.1 KiB
./gatsby-browser.tsx + 59 modules 258.5 KiB
./node_modules/.pnpm/@posthog+brand@0.13.0_react@18.3.1/node_modules/@posthog/brand/dist/generated/hoggies/svg/construction-1.mjs 248.5 KiB
./src/components/Pricing/PricingSlider/Slider.tsx + 87 modules 240.2 KiB
./node_modules/.pnpm/@posthog+brand@0.13.0_react@18.3.1/node_modules/@posthog/brand/dist/generated/hoggies/svg/construction-2.mjs 228.2 KiB
./node_modules/.pnpm/@posthog+brand@0.13.0_react@18.3.1/node_modules/@posthog/brand/dist/generated/hoggies/svg/magnifying-glass.mjs 221.7 KiB
./src/hooks/useProducts.tsx + 24 modules 155.6 KiB
./src/hooks/useProduct.ts + 9 modules 149.4 KiB
./src/components/Icons/Icons.tsx 147.4 KiB

Eager-graph budgets are report-only until a baseline is established. Sizes are gzip of public/**/*.js; eager size is webpack module source bytes for the modules actually shipped in the entrypoint's initial chunks (post-tree-shake).

@eli-r-ph eli-r-ph self-assigned this Oct 20, 2026
@eli-r-ph
eli-r-ph marked this pull request as ready for review October 27, 2026 17:58
@github-actions

github-actions Bot commented Oct 27, 2026 •

Copy link
Copy Markdown
Contributor

✅ The latest commit has no critical SEO/AEO risks that this check can find.

@eli-r-ph
eli-r-ph requested review from a team October 28, 2026 00:46

@dustinbyrne dustinbyrne 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.

Two API-reference details need correction: request-wide type-error handling and the legacy $ignore_sent_at compatibility promise. The navigation entry and billing redirect look consistent. Keep the documented pre-release publication holds in place.

AI-assisted review.

Comment thread contents/docs/api/capture-v1.mdx Resolved
Comment thread contents/docs/api/capture-v1.mdx Resolved
@dustinbyrne
dustinbyrne requested a review from a team October 28, 2026 14:53
@eli-r-ph
eli-r-ph requested a review from dustinbyrne October 28, 2026 22:33
eli-r-ph and others added 15 commits November 1, 2026 12:48
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…es and non-string ids are new

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

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

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
turnipdabeets added a commit that referenced this pull request Nov 12, 2026
#21385 deletes contents/docs/libraries/android/index.mdx
and redirects it to the generated SDK reference, with the migration guide
generated from posthog-android's MIGRATION.md. That guide and the 4.x
reference cover everything the 4.0 upgrade section and config table here
added, so drop this PR's changes to the page instead of conflicting.

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

turnipdabeets commented Nov 12, 2026 •

Copy link
Copy Markdown
Contributor

Heads-up from the posthog-android 4.0 release review. This PR is stacked on #22061, which deletes the hand-written SDK pages and redirects them to the references (I first attributed that to this PR; the page-anchor points are now on #22061).

captureAi links point at sections #22061 deletes. ai-observability/installation/manual-capture.mdx:50 and ai-observability/large-events.mdx:49 (from #21963) link /docs/libraries/ios/usage#ai-events, /docs/libraries/android#ai-events and /docs/libraries/flutter#ai-events. Once #22061 lands, they land on the reference without an anchor. For Android, I think /docs/libraries/android/reference#capture-ai is the target: the generated 4.x reference has a "Capture AI" section. iOS and Flutter probably need the same check.

🤖 Generated with Claude Code

turnipdabeets added a commit that referenced this pull request Nov 12, 2026
The upgrade guide now lives at /docs/libraries/flutter/migration (#21385),
so restore flutter/index.mdx to master, point the CocoaPods notice at the
migration guide, and scope the synchronous logs beforeSend rule to 6.0.

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

Copy link
Copy Markdown
Contributor

@gewenyu99 a heads-up on 428cf1b, which retires the hand-written SDK pages: other docs still link to anchors on those pages. The redirect drops the fragment's target, so readers land on the reference page without the section they wanted. For Flutter, at this PR's head:

  • docs/product-analytics/_snippets/how-to-capture-{anonymous,identified}-events-flutter.mdx → #anonymous-vs-identified-events
  • docs/product-analytics/autocapture.mdx → #interaction-autocapture, #rage-click-autocapture
  • docs/session-replay/_snippets/flutter-installation.mdx → #capturing-screen-views
  • docs/surveys/installation/flutter.mdx → #using-navigatorobservers, #using-go_router
  • tutorials/flutter-analytics.md → #capturing-events, #identifying-users, #removing-stored-super-properties, #group-analytics
  • tutorials/flutter-ab-tests.md → #capturing-events, #multivariate-feature-flags
  • tutorials/flutter-feature-flags.md → #feature-flags

The other retired pages have the same problem: 33 files under contents/ link /docs/libraries/{ios,android,react-native,js}#…. Run git grep -n "/docs/libraries/[a-z-]*#" -- contents to list them.

The link checker doesn't catch these, because the page still resolves through the redirect. (surveys/_snippets/flutter-surveys-installation.mdx is deleted in #20924, so skip that one.)

On the Flutter side, #20924 no longer edits libraries/flutter/index.mdx, so it won't conflict with this PR. Its v6 upgrade content lives in posthog-flutter's MIGRATION.md, which this PR publishes at /docs/libraries/flutter/migration.

eli-r-ph and others added 5 commits November 12, 2026 17:46
The iOS, Android and Flutter capture v1 majors ship in a later release, with
their own docs.

Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
…inks

Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
…ajors

- Rust: use the `posthog` crate on the transactional email page and in the
  analytics tutorial, whose code did not compile.
- Node: object-form `captureException` on two more pages; Fastify guide names
  posthog-node 6.
- Python: positional project token in the error tracking tutorial.
- Go: `SecretKey` in the secret key snippet.
- Restore notes from the retired upgrade page: proxies must return the capture
  response unchanged, older proxy guides, the AI capture spec link, and the
  separate client for historical migration.

Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
… spec

- Person-only events sent with person processing off are accepted, then
  dropped during ingestion.
- A large AI event sent with plain capture is reported as ai_event_too_big.
- Options are stored as properties only when they change the default.
- Add the ai_byte_rate_limited detail, the decompression error tag, null
  properties, repeated fields, ignored top-level fields and unknown results.
- Self-hosted body limits are a minimum, since the AI endpoint now takes more.
- Scope legacy-only statements on the timestamps, ingestion warnings and
  identify pages, and link the proxy reference from the API page.

Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
The event billing limit refuses the whole request, including exception,
survey and AI events. Name the three product quota details.

Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
@andyvan-ph
andyvan-ph removed the request for review from a team November 13, 2026 13:30
gewenyu99 and others added 4 commits November 13, 2026 10:58
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…nto HEAD

# Conflicts:
#	contents/docs/workflows/transactional-emails/rust.mdx
…nto HEAD

# Conflicts:
#	contents/docs/ai-observability/large-events.mdx
…r own quota

Matches PostHog/posthog#135788: the events quota drops other events one by
one with events_over_quota, and 402 means no event in the request was left
to store.

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

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Agent-drafted and reviewed by Manoel.

blocking: Rust attachment example still imports posthog_rs — line 199

This PR changes the install step to cargo add posthog@1 and renames every other posthog_rs:: path on this page to posthog::, but the "Copies and attachments" example still starts with use posthog_rs::{CodeEmail, EmailAttachment};. The 1.x SDK publishes the crate as posthog, so users (and coding agents, which the page's prompt points here) who follow the install step and copy this example get an unresolved-crate compile error. It should use posthog:: like the rest of the page.

Reproduction test — src/main.rs in a new binary crate whose Cargo.toml has posthog = { path = "<posthog-rs checkout at origin/v1>" } under [dependencies] (same package name as cargo add posthog@1):

// Line 199 of contents/docs/workflows/transactional-emails/rust.mdx at a0ed7d1031
use posthog_rs::{CodeEmail, EmailAttachment};
fn main() { let _ = std::any::type_name::<CodeEmail>(); let _ = std::any::type_name::<EmailAttachment>(); }

Run: cargo build --offline

Reproduction: reproduced — cargo build --offline against posthog-rs origin/v1 fails with error[E0432]: unresolved import posthog_rs, and rustc suggests use posthog::{CodeEmail, EmailAttachment};.

@marandaneto
marandaneto requested a review from a team November 16, 2026 13:04

@turnipdabeets turnipdabeets 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.

[suggestion] Approving from the mobile side. We still need the posthog_rs:: → posthog:: fix Manoel flagged at workflows/transactional-emails/rust.mdx:199 before this merges.

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docs Improvements or additions to product documentation, "Docs"

Projects

None yet

Development

Successfully merging this pull request may close these issues.

7 participants