Changelog — ODEN

Official version history for the ODEN API, listed in reverse chronological order. All backwards-incompatible revisions and schema additions are documented here.

v1.2.1 — 2026-09-02#

Performance — Edge preflight optimization: Accelerated CORS OPTIONS preflight negotiations across European Cloudflare points of presence, eliminating extraneous latency on cross-origin requests.
Reliability — Multi-region origin failover: Configured automated real-time health checks across redundant European upstream compute nodes to safeguard 99.9% uptime.
Documentation — Async client examples: Published comprehensive asynchronous integration guides and connection pooling recipes for Python (httpx) and TypeScript.

v1.2.0 — 2026-08-28#

Feature — Contextual snippet extraction: Added the include_snippets boolean request parameter. When set to true, each returned citation contains an attributed, one-sentence passage in citations[].snippet, eliminating separate page fetch calls for RAG pipelines.
Performance — Multilingual semantic reranker: Deployed updated neural passage rerankers optimizing ranking precision for Nordic languages (Swedish, Danish, Norwegian, Finnish) and primary European languages (German, French, Spanish).
Edge Cache — Sub-25ms warm lookups: Expanded Cloudflare Workers KV edge caching. Repeated queries returning identical synthesized answers are served globally in under 25 milliseconds.

v1.1.2 — 2026-08-18#

Source handling — TDM reservation parser: Strengthened crawler checks for machine-readable tdm-reservation HTTP headers and HTML meta tags before page indexing, helping teams document how source opt-outs are handled.
Observability — Diagnostic trace propagation: Standardized trace_id inclusion across all 4xx client errors and 5xx upstream exceptions to streamline distributed telemetry.
Reliability — Retry-After headers: HTTP 429 Rate Limit responses now include standard Retry-After integer headers indicating precise backoff wait times in seconds.

v1.1.0 — 2026-08-02#

Feature — Search depth selection: Introduced the depth parameter accepting "advanced" (default) and "basic". The basic mode bypasses deep DOM extraction to return snippet-level results in under 150ms for autocomplete, classification, and routing tasks.
Developer Experience — OpenAPI 3.1 specification: Published machine-readable API specifications at /openapi.json for automated client SDK generation and Swagger / Postman import.
Dashboard — Live quota telemetry: Added real-time usage visualization to the ODEN dashboard, tracking monthly query volume and remaining top-up allowances.

v1.0.0 — 2026-07-30#

Initial public General Availability (GA) release of the ODEN web search API.

Primary endpoint: POST /search accepting JSON requests with natural-language query and returning synthesized results.answer alongside ranked results.citations[].
Bearer token authentication: Secure API key management with oden_live_ prefixed tokens.
Plan tiers: Free tier providing 1,000 queries per month with no credit card required, Pro tier providing 6,000 queries per month at €29/month, and stackable top-up packs.
Health monitoring: Unauthenticated GET /health endpoint returning service availability status.

v0.9.5-beta — 2026-07-10#

Closed beta rollout: Distributed access to 150 initial AI engineers and agent builders.
Edge PoP optimization: Fine-tuned routing latency across Stockholm, Frankfurt, London, and Amsterdam Cloudflare edge locations.
Zero-reproduction verification: Audited extraction pipelines to confirm citations operate strictly as metadata references rather than unauthorized content replication.

v0.9.0-alpha — 2026-06-12#

Internal alpha milestone: Validated synthetic benchmark datasets across 50,000 multi-turn question sets evaluating retrieval precision, factual consistency, and hallucination reduction.

API versioning & stability policy#

ODEN follows Semantic Versioning (SemVer). We guarantee the following stability commitments for production integrators:

Backwards compatibility: Fields will not be removed or renamed within major version v1.x. New parameters and response attributes are added additively and will never break conforming JSON parsers.
Deprecation notice: In the rare event of an unavoidable breaking change, a minimum of 12 months formal notice will be provided via email, dashboard notifications, and this changelog.
Contract guarantees: The live endpoint contract remains fixed at POST https://api.oden-api.com/search.