data-src=../../includes/update-notice.md

Release notes

The following sections list updates to API Mesh for Adobe Developer App Builder.

To use the latest enhancements, update your CLI to the latest version:

aio plugins:install @adobe/aio-cli-plugin-api-mesh

Known issues

If you encounter a TypeError, such as HandlerCtor is not a constructor, when running a CLI command, you should uninstall and reinstall the API Mesh plugin and try the command again:

aio plugins:uninstall @adobe/aio-cli-plugin-api-mesh

aio plugins install @adobe/aio-cli-plugin-api-mesh

March 30, 2026

This release contains the following changes to API Mesh:

Enhancements

Added support for .graphql files in additionalTypeDefs, allowing you to reference .graphql files instead of using inline type definition strings.

March 23, 2026

This release contains the following changes to API Mesh:

Bug fixes

Resolved an issue with secrets management that could affect secret processing for certain data types.

January 07, 2026

This release contains the following changes to API Mesh:

Bug fixes

Resolved an issue where the Developer Console UI incorrectly displayed a status of "Provisioning" for successfully deployed meshes.

December 03, 2025

This release contains the following changes to API Mesh:

Enhancements

Added a prompting guide to generate API Mesh configurations using AI prompting techniques.

December 01, 2025

This release contains the following changes to API Mesh:

Bug fixes

Resolved an intermittent issue where provisioning context state that could cause a Context state is not configured for this mesh error.
Resolved a possible TypeError that could lead to 500 errors when your mesh is experiencing heavy traffic.

September 29, 2025

This release contains the following changes to API Mesh:

Bug fixes

Resolved an issue that could prevent retrieving logs in the CLI.

September 18, 2025

This release contains the following changes to API Mesh:

Enhancements

Added support for customer group–specific caching in API Mesh by enabling cache variance on custom headers with the x-api-mesh-vary header.

September 08, 2025

This release contains the following changes to API Mesh:

Bug fixes

Fixed a serialization error that could occur when using useGETForQueries with GraphQL handlers.

August 11, 2025

This release contains the following changes to API Mesh:

Enhancements

Added context.logger for hooks and custom resolvers.
Added context state to allow persisting reusable values for hooks and resolvers.
Added support for the following hooks:
- afterAll - Runs after querying all sources.
- beforeSource - Runs before querying a source.
- afterSource - Runs after querying a source.

Troubleshooting

If you encounter the following error, refer to Troubleshooting for a solution.

Mesh TypeError: Cache is not a constructor

August 08, 2025

This release contains the following changes to API Mesh:

Enhancements

Updated the user interface in the developer console to allow you to view the deployment history for your mesh.
Added an Open Playground button to the developer console user interface that allows you to interact with your mesh using a GraphiQL client.
Added an --active flag to the aio api-mesh:get command that allows you to retrieve the most recent successfully deployed mesh.

June 24, 2025

This release contains the following changes to API Mesh:

Enhancements

Added support for .graphql files in the files array.

June 24, 2025

This release contains the following changes to API Mesh:

Bug fixes

Fixed an error that could occur when using the aio api-mesh:run command with unreferenced files in your mesh configuration.

June 16, 2025

This release contains the following changes to API Mesh:

Enhancements

Resolved a 500 error that could occur when fetching a GraphQL source.

June 05, 2025

This release contains the following changes to API Mesh:

Enhancements

You can now create a mesh from a template using the aio api-mesh create --template command.
You can now get a list of log forwarding errors using the aio api-mesh:config:get:log-forwarding errors command.
Local composers now support fetching from remote origins using fetch().

May 22, 2025

This release contains the following changes to API Mesh:

Enhancements

Log forwarding now forwards key request and response headers, and HTTP access logs in addition to worker logs.
Standardized error messages for improved usability and debugging.

Bug fixes

Fixed an issue where OpenAPI handlers with int64 format properties could cause errors when querying.

May 12, 2025

This release contains the following changes to API Mesh:

Enhancements

Added the cf-ray and x-request-id response headers, which are passed in subrequests to your mesh sources, to assist with tracking and debugging.
Added support for older New Relic license keys when using log forwarding.
Updated the Adobe Commerce samples repository with a new response caching example.

April 22, 2025

This release contains the following changes to API Mesh:

Enhancements

This release introduces native caching for API Mesh, including how to verify caching behavior using response headers. It also provides guidance on source-driven caching.
Logging now includes HTTP details. To see these changes, perform a mesh update.
The log-get-bulk command now allows you to specify the number of minutes in the past to get logs.

Bug fixes

Deleting a mesh will now also delete the mesh's logging configuration.

April 17, 2025

This release contains the following changes to API Mesh:

Enhancements

A new experimental feature allows you to forward logs to New Relic using the aio api-mesh:config:set:log-forwarding command.
The CLI now warns you if you have includeHTTPDetails set to true in your mesh configuration. This is a security risk and should not be used in production.

April 03, 2025

This release contains the following changes to API Mesh:

Bug fixes

Resolved an issue where breakpoints were not respected in local development when using the aio api-mesh run command.

March 27, 2025

This release contains the following changes to API Mesh:

Bug fixes

Resolved an encoding issue that could cause problems when interacting with a mesh. Update your CLI to the latest version, if you experience similar issues.
Resolved an issue that prevented certain additionalResolvers from functioning correctly when using local development.

March 03, 2025

This release contains the following changes to API Mesh:

Enhancements

Hooks are now supported in local development for edge meshes.
Improved the information provided in the CLI when requesting the status of a provisioning mesh with the aio api-mesh:status command.

February 26, 2025

This release contains the following changes to API Mesh:

Bug fixes

Resolved an issue that could cause truncated logs.

February 19, 2025

This release contains the following changes to API Mesh:

Enhancements

Authorization improvements to the CLI. To install the latest version of the API Mesh plugin, run the following command:
```
aio plugins:install @adobe/aio-cli-plugin-api-mesh
```
The CLI now notifies you when a new version of the aio-cli-plugin-api-mesh plugin is available.

February 6, 2025

This release contains the following changes to API Mesh:

Enhancements

Native caching closed beta is now available for edge meshes.
Local development is now available for edge meshes.
- Hooks are currently not supported in local development.
Internal authorization improvements.

January 09, 2025

This release contains the following changes to API Mesh:

Bug fixes

Fixed an issue where downstream errors were not logged correctly.
Internal efficiency improvements.