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

September 29, 2026

This release contains the following changes to API Mesh:

Enhancements

Mesh config size limits have increased:

Without a files array: The config size limit is 375KB.
With a files array: The config size limit is 750KB.

If you encounter issues with the config size, reduce the size of sources, transforms, or other config content. If you are not already using a files array, add one and move content into it to benefit from the larger config size limit.

Bug fixes

Resolved an error that could cause meshes with redirected endpoints to get stuck in the build phase.

September 01, 2026

This release contains the following changes to API Mesh:

Bug fixes

Improved error handling for rejections caused by exceeding a configured query limit.
Resolved an issue that could causes errors when running aio api-mesh init.

June 03, 2026

This release contains the following changes to API Mesh:

Enhancements

Added queryConfig, a new top-level mesh configuration object that allows you to harden your mesh against oversized, abusive, or schema-probing GraphQL queries. All protections are disabled by default. Supported controls include: 
- blockFieldSuggestion - Suppresses hints in error responses to prevent schema enumeration.
- costLimit - Rejects queries whose computed cost exceeds the configured maximum.
- maskErrors - Replaces unintentional resolver errors with a generic message so internal details are not leaked to clients.
- maxAliases - Limits the number of aliases used in a single query.
- maxDepth - Limits the nesting depth of incoming queries.
- maxDirectives - Limits the number of directives used in a single query.
- maxTokens - Limits the total number of GraphQL tokens parsed per query.

May 14, 2026

This release contains the following changes to API Mesh:

Enhancements

Added support for referencing a local .graphql schema file directly from a graphql handler's source field. The file is automatically resolved and attached to your mesh, so large schemas can be stored separately instead of being embedded in your mesh configuration.

April 28, 2026

This release contains the following changes to API Mesh:

Bug fixes

Local Secrets Now Support JSON-Encoded Values - The local aio api-mesh run command now properly handles JSON-encoded secret values in the same way the deployed tenant worker does.

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.