Add-on parity for Subscription Update v2 GraphQL API

^{Major Upgrade}

❗ Important: This feature is currently in Early Availability (EA). For more information on feature status, see Product lifecycle phases.

Subscription Update v2 GraphQL mutations now support Add-on updates using the same request and response contract as base subscriptions. Partners can manage Add-on subscription lifecycle operations through the GraphQL API without using legacy REST endpoints, including quantity, edition, and contract updates. This enables headless commerce integrations to deliver self-serve Add-on management through partner storefronts.

Coverage includes both Self-Serve Add-ons and Assisted Sales Add-ons. The mutation resolves parent associations internally, so callers do not need to supply a synthetic parent association.

📝 Note: No UI changes are included. The marketplace interface already supports Add-on updates. This release updates the API surface only.

Supported operations

Add-on updates through Subscription Update v2 support the same operation types available for base subscriptions in this API, including:

• Quantity updates (single Add-on, and multiple Add-ons in one request where the underlying flow supports it)
• Edition changes
• Contract updates
• Discounts
• Subscription custom attributes
• Delayed downgrades
• Free trial and free-plan transitions
• Setup, flat, and per-unit fee handling consistent with the base subscription flow

Important

• Add-ons v1 (legacy) remain unsupported.
• Bundles, physical products, and domains remain out of scope for this API update.
• Bulk (multi-subscription) Add-on updates are not included in this release.

Feature enablement

No feature enablement is required.

Setting enablement

No setting enablement is required.

Documentation

Public API documentation at developer.appdirect.com includes Add-on payload examples and any Add-on-specific fields or constraints.