Skip to content

🪢 Open source agent evals & observability: Trace, evaluate, and improve LLM applications with one open platform.

feat(api): say legacy endpoints delay data by about 10 minutes (#17260)

Max Deichmann2c44151e2a1f
diff --git a/web/src/__tests__/server/unit/openapi-deprecations.servertest.ts b/web/src/__tests__/server/unit/openapi-deprecations.servertest.ts
index e352d01c48..04f70cdbb8 100644
--- a/web/src/__tests__/server/unit/openapi-deprecations.servertest.ts
+++ b/web/src/__tests__/server/unit/openapi-deprecations.servertest.ts
@@ -12,6 +12,14 @@ import {
stampDeprecations,
} from "../../../../scripts/openapi/stamp-deprecations";
import {
+ DATASET_RUN_ITEMS_DEPRECATION,
+ DATASET_RUNS_DEPRECATION,
+ METRICS_DEPRECATION,
+ OBSERVATIONS_V1_DEPRECATION,
+ SCORES_DEPRECATION,
+ SESSIONS_DEPRECATION,
+ TRACES_DEPRECATION,
+ V3_DELAY_NOTICE,
V3_SUNSET_DATE,
V3_SUNSET_HUMAN,
} from "@/src/features/public-api/server/deprecations";
@@ -158,6 +166,24 @@ describe("OpenAPI deprecations", () => {
).toBe(V3_SUNSET_HUMAN);
});
+ // Every family that already stamps `_deprecation` shares V3_NOTICE, so a new
+ // family that forgets it would ship without the delay warning.
+ it("puts the 10-minute delay on every legacy `_deprecation.message`", () => {
+ const families = [
+ OBSERVATIONS_V1_DEPRECATION,
+ TRACES_DEPRECATION,
+ SESSIONS_DEPRECATION,
+ SCORES_DEPRECATION,
+ METRICS_DEPRECATION,
+ DATASET_RUN_ITEMS_DEPRECATION,
+ DATASET_RUNS_DEPRECATION,
+ ];
+
+ for (const family of families) {
+ expect(family.message).toContain(V3_DELAY_NOTICE);
+ }
+ });
+
it("supports deprecated endpoints at a service base path", () => {
withDefinition(
{
diff --git a/web/src/features/public-api/server/deprecations.ts b/web/src/features/public-api/server/deprecations.ts
index ca05b02680..bd0ab3f0d3 100644
--- a/web/src/features/public-api/server/deprecations.ts
+++ b/web/src/features/public-api/server/deprecations.ts
@@ -13,7 +13,10 @@ export const V3_SUNSET_HUMAN = "November 16, 2026";
// Shared deprecation reason — references the deprecated Langfuse v3 system
// version (not an API version). Customer-facing wording lives here — edit once.
-const V3_NOTICE = `On Langfuse Cloud, Langfuse v3 is deprecated and this endpoint will be removed on ${V3_SUNSET_HUMAN}.`;
+export const V3_DELAY_NOTICE =
+ "Data on this API is delayed by about 10 minutes. Real-time is only OpenTelemetry writes plus v2 observations and v2 metrics reads.";
+
+const V3_NOTICE = `On Langfuse Cloud, Langfuse v3 is deprecated and this endpoint will be removed on ${V3_SUNSET_HUMAN}. ${V3_DELAY_NOTICE}`;
// v4 replacement endpoints, referenced by both the message and `replacement`.
// Placeholder style matches rateLimitUpgradePaths (<from>, <to>, filters).