> ## Documentation Index > Fetch the complete documentation index at: https://agenticadvertisingorg-addie-wg-slack-context.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Versions & Compatibility > Every published AdCP version, its status, and its end-of-life date. Start here if you're choosing or upgrading a version. ## At a glance **Choosing today:** new production integrations should use 3.1 with wire pin `"3.1"`. Use the exact 3.2 prerelease pin only in development or staging after the peer advertises it. | Status | Versions | Wire pin | What it means | | --------------------- | -------------------------------- | ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Release candidate** | 3.2 (current prerelease: `rc.3`) | `"3.2-rc.3"` | Development and staging only. RC.3 is the current signed protocol checkpoint, tagged and published as [`v3.2.0-rc.3`](https://github.com/adcontextprotocol/adcp/releases/tag/v3.2.0-rc.3). TypeScript `@adcp/sdk@14.0.0-rc.40` embeds RC.3 exactly; Python SDK beta.14 and Go SDK 3.2.1 still embed RC.1. Follow the [3.2 prerelease program](/dist/docs/3.2.0-rc.6/reference/3-2-beta). | | **Active** | 3.1 (current stable: 3.1.23) | `"3.1"` | Current production minor release. See [What's New in AdCP 3.1](/dist/docs/3.2.0-rc.6/reference/whats-new-in-3-1) for the feature set. | | **Maintained** | 3.0 (current stable: 3.0.26) | `"3.0"` | Supported previous minor for existing production integrations. Receives compatibility and security patches. | | **End of life** | 2.0.0, 2.1.0, 2.5.0–2.5.3 | — | No patches. Migrate to 3.0. See [v2 sunset](/dist/docs/3.2.0-rc.6/reference/v2-sunset). | | **Planned** | 4.0 | — | Target in [planned releases](/dist/docs/3.2.0-rc.6/reference/versioning#planned-releases). | **Wire values are release-precision only.** Send `"3.1"` for the stable 3.1 line or `"3.0"` for the maintained 3.0 line. Do not send patch components like `"3.0.19"` or full semver pre-release values like `"3.1.0-rc.15"`. Historical prerelease pins such as `"3.1-rc.15"` remain valid only for agents that explicitly advertise those prerelease values. See [patches are not negotiated](/dist/docs/3.2.0-rc.6/reference/versioning#patches-are-not-negotiated). *Status legend: Pending beta = announced but not yet published. Beta and release candidate = immutable prerelease checkpoints for development and staging. A one-time cleanup on 2026-09-14 retired some historical 3.x beta bundles from the repository and runtime image; remaining and future published prerelease artifacts stay immutable, and retired beta URLs are served from the artifact CDN on a best-effort basis only. Active = current stable generation. Maintained = supported previous minor. Security-only = patches for security issues only, no features. End of life = no patches. Planned = not yet released.* ## All published versions ### 3.x — current generation | Version | Released | Notes | | ------------------------- | ------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 3.0.0 | 2026-04-22 | GA — stable baseline for the 3.x cycle. | | 3.0.1 through 3.0.10 | 2026-04-28 to 2026-05-10 | Patches. Wire-compatible with 3.0.0. | | 3.0.11 through 3.0.15 | 2026-05-11 to 2026-05-31 | Patches. Wire-compatible with 3.0.0. | | 3.0.16 through **3.0.26** | 2026-06-14 to 2026-08-21 | Patches. **3.0.26 is the latest stable patch.** Wire-compatible with 3.0.0. | | 3.1.0 | 2026-06-18 | GA — current production minor release. Use wire pin `"3.1"`. | | 3.1.1 | 2026-06-30 | Patch. Wire-compatible with 3.1.0. | | 3.1.2 | 2026-07-08 | Patch. Wire-compatible with 3.1.0. | | 3.1.3 | 2026-07-13 | **Withdrawn. Do not use.** It added a stable schema field in a patch release and included an incorrect publisher-domain filter implementation. The artifacts remain available only for auditability. Use 3.1.2 instead. | | 3.1.4 through 3.1.21 | 2026-07-18 to 2026-09-09 | Supported patches. Wire-compatible with 3.1.0. | | 3.1.22 | 2026-09-13 | Emergency privacy/security corrections changed the explicitly experimental TMP contract under the recorded notice exception; see the [v3.1.22 release note](/dist/docs/3.2.0-rc.6/reference/release-notes#version-3-1-22). | | **3.1.23** | 2026-09-14 | **Latest stable patch.** Carries the corrected v3.1.22 release record and compliance gating fixes. Wire-compatible with 3.1.0. | Supported patches don't change stable wire surfaces. Upgrading among supported 3.0.x patches is safe, and stable 3.1 surfaces remain additive over 3.0. The withdrawn 3.1.3 release is not a supported patch or implementation target. Version 3.1.22 changed the explicitly experimental TMP contract under the documented emergency security exception to its normal notice process. For per-version detail, see [Release Notes](/dist/docs/3.2.0-rc.6/reference/release-notes) (curated narrative) and the [Changelog](/dist/docs/3.2.0-rc.6/reference/changelog) (full technical history). ### Prereleases | Version | Released | Notes | | ------------------------------ | ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **3.2.0-rc.3** | 2026-09-14 | Current protocol checkpoint, published as [`v3.2.0-rc.3`](https://github.com/adcontextprotocol/adcp/releases/tag/v3.2.0-rc.3). Hardens the experimental Reliable Reporting consumer-status loop (`content_mismatch` with a closed `mismatch_code`, a bounded grace window for a stale `received`, the buyer posting deadline and `obligation_counts.consumer_status_pending`, issue lifecycle fields, and the reserved `authoritative_party` value), adds a shared MediaBuy-level `frequency_cap` with structured product frequency-cap constraints, and adds request-only targeting inputs with `null`-clear semantics. TypeScript `@adcp/sdk@14.0.0-rc.40` embeds it exactly; use `"3.2-rc.3"` only with peers that explicitly advertise it. | | 3.2.0-rc.2 | 2026-09-13 | Previous protocol checkpoint. Adds the opt-in experimental Reliable Reporting `sync_reporting_status` consumer-status loop, buyer and orchestrator storyboards with a buyer-orchestrator compliance track, cursor pagination for truncated `get_media_buy_delivery` breakdowns, sub-country product coverage filters, and restored `canonical-forecast-point` constraints. No maintained SDK embeds it. | | 3.2.0-rc.1 | 2026-09-05 | Previous protocol checkpoint. Completes the experimental Reliable Reporting 1.0 contract and hardens delivery, reach, and vendor-metric semantics. TypeScript SDK RC.35, Python `adcp==8.0.0b14`, and Go `adcp/v3@v3.2.1` embed it exactly. | | 3.2.0-rc.0 | 2026-09-03 | First 3.2 release candidate. TypeScript SDK beta.31 and Python SDK beta.13 embed it exactly; Go SDK 3.2.0 remains generated from beta.9. | | 3.2.0-beta.11 | 2026-09-03 | Previous protocol checkpoint. Adds `get_principal` to the MCP media-buy role profile alongside `sync_principal`, and aligns training-agent and compliance guidance with the beta.10 bundle. TypeScript SDK beta.29 and Python SDK beta.12 embed it exactly. | | 3.2.0-beta.10 | 2026-09-01 | Previous protocol checkpoint. Adds managed reporting delivery, authenticated principals, audio VAST and DOOH support, programmed channel collections, and committed collection selection. TypeScript SDK beta.28 and Python SDK beta.11 embed it. | | 3.2.0-beta.9 | 2026-08-28 | Previous protocol checkpoint. Adds the draft account change feed, product-scoped inventory-list receipts, authority-discriminated inventory delivery identity, seller policy and change-right contracts, and broader conformance coverage. | | 3.2.0-beta.8 | 2026-08-27 | Previous protocol checkpoint. Proves metric-container subsumption behavior end to end and repairs versioned documentation snapshot builds. | | 3.2.0-beta.7 | 2026-08-27 | Previous protocol checkpoint. Adds audience activation and external-source contracts, creative delivery and tracker execution contracts, static OOH and radio measurement declarations, viewed-seconds distributions, and expanded conformance coverage. | | 3.2.0-beta.6 | 2026-08-23 | Previous SDK-backed checkpoint. `@adcp/sdk@14.0.0-beta.13` and Python `adcp==8.0.0b9` embed this exact bundle. | | 3.2.0-beta.5 | 2026-08-22 | Previous SDK-backed checkpoint. Python `adcp==8.0.0b7` embeds this exact bundle. | | 3.2.0-beta.4 | 2026-08-20 | Integration checkpoint, superseded by beta.5 for new beta testing. Adds flexible-window availability discovery and the outcome\_target reverse-forecast input. | | 3.2.0-beta.3 | 2026-08-19 | Integration checkpoint, superseded by beta.4 for new beta testing. | | 3.2.0-beta.2 | 2026-08-19 | Integration checkpoint, superseded by beta.3 for new beta testing. | | 3.2.0-beta.1 | 2026-08-19 | Integration-correction checkpoint, superseded by beta.2 for new beta testing. | | 3.2.0-beta.0 | 2026-08-17 | Protocol-first beta input for SDK work. Retired from the repository and runtime image on 2026-09-14 together with the other 3.x betas except `3.2.0-beta.11` (frozen `3.2-beta` documentation selector), `3.2.0-beta.6` (training-agent retained checkpoint), and `3.1.0-beta.7` (TypeScript SDK side bundle); pinned adopters should move to `3.2.0-rc.3`. | | 3.1.0-rc.1 through 3.1.0-rc.15 | 2026-05-29 to 2026-06-16 | Superseded by 3.1.0 GA. These artifacts remain available for pinned prerelease adopters and release forensics. | | 3.0.0-beta.1 through rc.2 | 2026-01-26 to 2026-03-15 | Superseded. | | 3.0.0-rc.3 | 2026-04-01 | Superseded by GA. See [prerelease upgrade notes](/dist/docs/3.2.0-rc.6/reference/migration/prerelease-upgrades) if you adopted rc.3. | ### 2.x — end of life | Version | Released | Notes | | ------- | ------------ | ---------------------------------------- | | 2.0.0 | 2025-10-15 | End of life. No patches. Migrate to 3.0. | | 2.1.0 | 2025-10-19 | End of life. No patches. Migrate to 3.0. | | 2.5.0 | 2025-11-22 | End of life. No patches. | | 2.5.1 | 2025-12-24 | End of life. No patches. | | 2.5.2 | 2026-01-07 | End of life. No patches. | | 2.5.3 | January 2026 | End of life. **Last 2.x release.** | The entire 2.x line has been fully deprecated since August 1, 2026 (UTC). The 2.x schema URLs continue to resolve so existing integrations don't break silently, but those schemas receive no further updates. See [v2 Sunset](/dist/docs/3.2.0-rc.6/reference/v2-sunset) for migration paths. ## FAQ ### What's "current"? For new production integrations, **3.1.23** is current; pin your integration to `"3.1"` (not `"3.1.23"`). Existing 3.0 integrations can remain pinned to `"3.0"` while they migrate. Use 3.2 only for prerelease testing with an exact advertised pin. See [Version negotiation](/dist/docs/3.2.0-rc.6/reference/versioning#version-negotiation). ### What happened to 2.2, 2.3, 2.4, 2.6? The 2.x line skipped version numbers during its working-group cycle. Some appear as in-flight changelog entries but were never released — the changes were rolled forward into the next published version or deferred to 3.0. The six published 2.x releases are 2.0.0, 2.1.0, 2.5.0, 2.5.1, 2.5.2, and 2.5.3. ### Can I still register a v2 agent? Yes — v2 agents can be registered in the AgenticAdvertising.org registry but cannot be verified. Certification and verified-default discovery require v3.x. See [v2 Sunset → If you use the AgenticAdvertising.org registry](/dist/docs/3.2.0-rc.6/reference/v2-sunset#if-you-use-the-agenticadvertisingorg-registry). ### How long will 3.0 be supported? At least 12 months after 4.0 GA. See [Versioning → Support window for previous major](/dist/docs/3.2.0-rc.6/reference/versioning#support-window-for-previous-major). ### Where is 4.0? Targeted for early 2027. 3.x is mid-cycle — see the [planned releases table](/dist/docs/3.2.0-rc.6/reference/versioning#planned-releases). ## Choosing a version | If you are… | Use | | ------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Building a new production integration today | **3.1**. Pin `"3.1"` on the wire. | | Implementing or testing 3.2 without an SDK | Use the signed **3.2 RC.3** artifacts with raw-wire or code-generation workflows. Follow the [prerelease program](/dist/docs/3.2.0-rc.6/reference/3-2-beta). | | Running an SDK-backed 3.2 integration test | Pair `@adcp/sdk@14.0.0-rc.40` with the exact RC.3 wire pin `"3.2-rc.3"`. Python `adcp==8.0.0b14` and Go `adcp/v3@v3.2.1` remain paired with RC.1 and `"3.2-rc.1"`. | | Running an existing 3.0 integration | Stay on **3.0** while you migrate, or move to **3.1** when your SDK and validation are ready. | | Running a 2.5.x integration | Upgrade now — out of support. Start with the [migration guide](/dist/docs/3.2.0-rc.6/reference/migration). | | Running a 2.0 or 2.1 integration | Upgrade now — out of support. | | Trying a post-3.1 feature | Use the [3.2 prerelease program](/dist/docs/3.2.0-rc.6/reference/3-2-beta), [Release Notes](/dist/docs/3.2.0-rc.6/reference/release-notes), and [experimental status](/dist/docs/3.2.0-rc.6/reference/experimental-status). | ## Related * **[Versioning & Governance](/dist/docs/3.2.0-rc.6/reference/versioning)** — release tiers, schema-change scope, cadence policy * **[v2 Sunset](/dist/docs/3.2.0-rc.6/reference/v2-sunset)** — full v2 end-of-life timeline and migration paths * **[What's new in v3](/dist/docs/3.2.0-rc.6/reference/whats-new-in-v3)** — feature-by-feature summary of what 3.0 adds * **[What's New in AdCP 3.1](/dist/docs/3.2.0-rc.6/reference/whats-new-in-3-1)** — final 3.1 feature set and adopter actions * **[What's new in AdCP 3.2](/dist/docs/3.2.0-rc.6/reference/whats-new-in-3-2)** — prerelease feature set and adopter actions * **[3.2 prerelease program](/dist/docs/3.2.0-rc.6/reference/3-2-beta)** — current artifacts, exact SDK pairing, and prerelease testing gates * **[Release Notes](/dist/docs/3.2.0-rc.6/reference/release-notes)** — curated narrative for each version * **[Changelog](/dist/docs/3.2.0-rc.6/reference/changelog)** — full technical change history