Skip to content

docs: clarify v4 observation response contracts - #3757

Draft
hassiebp wants to merge 3 commits into
mainfrom
hassiebbot/v4-migration-response-contracts
Draft

hassiebp wants to merge 3 commits into
mainfrom
hassiebbot/v4-migration-response-contracts

Conversation

@hassiebp

@hassiebp hassiebp commented Sep 8, 2026

Copy link
Copy Markdown
Contributor

Document the v2 observation response-field mappings, literal dotted metadata keys, ignored field groups, and valid empty usage/null costs so migrations update downstream readers as well as request methods. Populate the generation example with OTEL resource attributes and clarify that scans and known trace ranges should use time bounds.

Validation: current-head CI is green, including formatting, H1 checks, production build/link checks, sitemap checks, and Vercel preview. Local validation before review included Node.js 22 formatting, MDX compilation, generated Markdown checks, and response JSON/cursor consistency. No live project reads were performed.

Publish these docs before langfuse/skills#111, which directs agents to the response contract and examples.

Linear: https://linear.app/clickhouse/issue/LFE-16083/close-v4-migration-response-contract-and-verification-gaps

@vercel

vercel Bot commented Sep 8, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
langfuse-docs Ready Ready Preview Sep 8, 2026 12:03pm UTC

Request Review

Comment thread content/docs/api-and-data-platform/features/observations-api.mdx Outdated
Comment thread content/docs/api-and-data-platform/features/observations-api.mdx Outdated
Comment thread content/docs/api-and-data-platform/features/observations-api.mdx Outdated
Comment thread content/faq/all/deprecated-api-migration.mdx Outdated
Co-authored-by: Hassieb Pakzad <68423100+hassiebp@users.noreply.github.com>
@hassiebp hassiebp changed the title docs: clarify v4 response contracts and migration verification docs: clarify v4 observation response contracts Sep 8, 2026

This branch was successfully deployed

1 active deployment
Preview 5d90ab50 Deployed Sep 8, 2026 by vercel[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