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
.graphqlfiles inadditionalTypeDefs, allowing you to reference.graphqlfiles 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 mesherror. - Resolved a possible
TypeErrorthat could lead to500errors 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. <!-- CEXT-5292 -->
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
useGETForQuerieswith GraphQL handlers.
August 11, 2025
This release contains the following changes to API Mesh:
Enhancements
-
Added
context.loggerfor 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
--activeflag to theaio api-mesh:getcommand 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
.graphqlfiles in thefilesarray.
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:runcommand with unreferenced files in your mesh configuration.
June 16, 2025
This release contains the following changes to API Mesh:
Enhancements
- Resolved a
500error 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 --templatecommand. - You can now get a list of log forwarding errors using the
aio api-mesh:config:get:log-forwarding errorscommand. - 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
int64format properties could cause errors when querying.
May 12, 2025
This release contains the following changes to API Mesh:
Enhancements
- Added the
cf-rayandx-request-idresponse 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-bulkcommand 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-forwardingcommand. -
The CLI now warns you if you have
includeHTTPDetailsset totruein 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 runcommand.
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
additionalResolversfrom 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:statuscommand.
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-meshplugin 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.