Skip to content

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

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

eli-r-ph wants to merge 99 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 16, 2026 10:26PM

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 38 errors, 1159 warnings, 37 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/docs/_snippets/python-sdk-version-note.mdx 0 2 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 1 0
contents/docs/ai-observability/large-events.mdx 0 16 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/nodejs.mdx 0 2 0
contents/docs/distributed-tracing/installation/python.mdx 0 2 0
contents/docs/error-tracking/capture.mdx 0 5 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/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/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 5 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/fastify.mdx 0 10 0
contents/docs/libraries/flask.mdx 1 7 0
contents/docs/libraries/hono.mdx 0 7 0
contents/docs/libraries/js/config.mdx 1 52 1
contents/docs/libraries/nestjs.mdx 0 2 1
contents/docs/libraries/nuxt-js-3-6.mdx 0 10 0
contents/docs/libraries/python/_snippets/django-context-middleware.mdx 0 3 3
contents/docs/libraries/react-router/react-router-v7-framework-mode.mdx 0 3 0
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/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 10 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/privacy.mdx 0 5 0
contents/docs/mcp-analytics/start-here.mdx 0 0 2
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/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/web-analytics/bot-detection.mdx 0 16 6
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/wizard-and-docs/wizard-edge-cases.mdx 0 423 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/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/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/llm-ab-tests.md 0 24 0
contents/tutorials/mcp-analytics.mdx 0 19 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/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

@github-actions

github-actions Bot commented Oct 19, 2026 •

Copy link
Copy Markdown
Contributor

Bundle report

Total JS (gzip)

12.21 MiB (-5.4 KiB / -0.0%)

Largest changed named chunks
Chunk Gzip Δ vs master
d53be7e4323c811b7b208da3a1f00becabbdd275.js 449.1 KiB -5.6 KiB / -1.2%

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

Entrypoint Eager size Budget Modules
✅ app 11.15 MiB (+0.5 KiB / +0.0%) report-only 1107
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 1023.1 KiB
./src/components/Stickers/Stickers.tsx 696.4 KiB
./node_modules/.pnpm/@posthog+brand@0.13.0_react@18.3.1/node_modules/@posthog/brand/dist/generated/hoggies/svg/puzzle.mjs 388.5 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/@posthog+brand@0.13.0_react@18.3.1/node_modules/@posthog/brand/dist/generated/hoggies/svg/basketball-coach.mjs 337.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 + 60 modules 259.4 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/useProduct.ts + 18 modules 166.8 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>
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>
@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.

gewenyu99 and others added 4 commits November 16, 2026 13:51
…versions as 8.x.x and 8.0.0

The capture v1 table on "Choosing a PostHog SDK" linked the Node.js
migration guide on GitHub. It now links /docs/libraries/node/migration,
like the other SDKs, and each SDK name links its reference page.

Version numbers now use the 8.x.x and 8.0.0 form, which the migration
page titles also use.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
# Conflicts:
#	contents/docs/product-analytics/identify.mdx
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@eli-r-ph
eli-r-ph requested a review from marandaneto November 16, 2026 20:50

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