Added Reference Expansion in API Extensions | HTTP API

Added Reference Expansion in API Extensions

12 March 2026

Composable Commerce

HTTP API

Enhancement

ExtensibilityGraphQL

We added Reference Expansion in API Extensions in public beta.

You can now configure up to three expansion paths for an API Extension. The payload sent to the API Extension then contains the expanded referenced objects. This allows you to process business logic that requires data from related objects in the same request. Previously, you had to make additional API requests to retrieve the data from referenced objects.

Be aware of the limits of this feature and its performance impact.

We have implemented the following changes to our REST and GraphQL schemas:

REST API

Added expansionPaths field to Extension and ExtensionDraft.
Added Set Expansion Paths update action.

GraphQL API

Added expansionPaths field to Extension type.
Added expansionPaths field to ExtensionDraft input type.
Added setExpansionPaths field to ExtensionUpdateAction input type.
Added SetExtensionExpansionPaths input object type.