Skip to content

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

Merged
eli-r-ph merged 104 commits into
sdk-markdown-reference-js-navfrom
eli/capture-v1-api-reference
Nov 17, 2026
Merged

eli-r-ph merged 104 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 17, 2026 07:02PM

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

73 more changed pages are not listed.

@github-actions

github-actions Bot commented Oct 19, 2026 •

Copy link
Copy Markdown
Contributor

Vale prose linter → found 37 errors, 1165 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/_snippets/before-send-hook.mdx 0 3 0
contents/docs/error-tracking/capture.mdx 0 7 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 0 1 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.22 MiB (-5.3 KiB / -0.0%)

Largest changed named chunks
Chunk Gzip Δ vs master
d53be7e4323c811b7b208da3a1f00becabbdd275.js 449.3 KiB -5.4 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>
…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
gewenyu99 and others added 5 commits November 16, 2026 17:08
…-api-reference

One conflict, in mcp-analytics/installation/typescript.mdx: keeps master's
note on the default tool arguments (#22354) under the options table, then
this branch's Event options section.
posthog-node 6.0 reads only beforeSend (posthog-js #5757), so the Node.js
before_send examples would be silently ignored. The error tracking capture
page and the before-send snippet now show beforeSend for Node.js with a
Node example; the React email page installs posthog-node@6; the capture v1
types note names both hook spellings.
…tion filter key

- Rewrite the en-dash connectors this PR added as sentences, commas or colons.
- Name the minimum versions for event options: @posthog/ai 8.21.0 and
  @posthog/mcp 1.3.0 (their pending minor changesets on capture-v1).
- The web and React Native before-send examples filtered on
  exception["$exception_type"], which no SDK sets on $exception_list entries;
  posthog-js core's ErrorPropertiesBuilder sets `type`, so the filter never
  matched. They now check `type`, as the Node.js example does.
@eli-r-ph
eli-r-ph merged commit 1464436 into master Nov 17, 2026
23 checks passed
@eli-r-ph
eli-r-ph deleted the eli/capture-v1-api-reference branch November 17, 2026 19:52
An error occurred while trying to automatically change base from sdk-markdown-reference-js-nav to master November 17, 2026 20:31
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