Contact Us 1-800-596-4880

API Manager 2.x Release Notes

API Manager release notes include information about changes, new features, improvements, and resolved issues in releases of API Manager.

Note: Only API Manager 2.x can manage Mule 4 APIs.

Browser Support

Anypoint Platform supports the following browsers:

  • Firefox (latest version)

  • Chrome (latest version)

  • Internet Explorer 11 and newer


August 23, 2023

What’s New

  • For requests made from Connected Apps, API Manager Audit logs now include the Connected App’s name and ID.

  • The Mule API Analytics tab is now visible to users with View APIs Configuration permission.

  • Some error messages are now improved for clarity.


August 7, 2023

What’s New

  • External Bad Request (400) errors do not convert to Bad Gateway (502) errors.

  • This release contains accessibility improvements in the UI, including the addition of alternative texts for images and alternative visual and non-visual indicators.

Fixed Issues

Issue Resolution


You can now apply Mule 4 custom policies uploaded to Exchange via Maven as automated policies in an environment without APIs.



July 20, 2023

What’s New

Fixed Issues

Issue Resolution


Autocomplete for the Upstream URL field now works correctly. API Manager now only autocompletes the field when the page is first loaded and only if the information is available.


The Client provider field now shows the correct provider when editing an API instance.



July 3, 2023

What’s New

  • When adding a new API instance, there are now separate pages for the upstream and downstream configuration settings.

  • When editing an API instance from the settings page, there are now separate sections for the upstream and downstream configuration settings.


June 6, 2023

What’s New

  • Selecting an API instance from API Administration now navigates you to the new API Summary page instead of the API Settings page. The API Key Metrics and the API instance information such as the type, API version, and API instance ID now appear on the API Summary page. Only the runtime and endpoint configuration still appear on the Settings page.

  • In API Administration, the Analytics tab is now Mule API Analytics.


May 23, 2023

Fixed Issues

Issue Resolution


The API Instance field now appears correctly when filtering client applications with Datagraph contracts.



May 10, 2023

Fixed Issues

Issue Resolution


API Manager now correctly shows disabled policies.



April 14, 2023

What’s New

  • Connected Apps can create and manage client applications. For more information, see Creating Client Applications with Connected Apps.

  • API status is now shown as active only when deployment is successful.

  • API Manager uses a standalone replica list to report configuration status based on the version of each connected replica.

Fixed Issues

Issue Resolution


When a deployed API instance with policies applied is deleted, the policies are also deleted.



March 28, 2023

What’s New

You can deploy Mule Gateway proxy applications directly to CloudHub 2.0.

Fixed Issues

When applying policies to non-REST APIs, policies only applicable to REST APIs are not visible.


February 22, 2023

What’s New

For Flex Gateway running in Connected Mode, API Manager now supports:


January 18, 2023

What’s New

For API Instances, the Implementation URI and Consumer endpoint fields now:

  • Validate if the specified URL is a valid URL.

  • Support parameterization using {}, <>, or <<>>.


November 8, 2022

What’s New

Added TLS inbound and outbound support for RTF targets.


November 2, 2022

What’s New

The API Header on the settings page is improved for a better experience:

  • The API actions are now inside the Actions button in the page header title.

  • The API header is now only informative. The content in the API header is not editable, and the edit buttons were removed. The API instance label and API consumer endpoint fields editable in the API header are now only editable in the Endpoint configuration section following the API header.

  • For Mule 4 APIs, since the auto-discovery ID is the same as the API instance ID, the auto-discovery ID was removed for clarity. The API Manager docs are updated to highlight this change and instruct users where to find the API instance ID.

  • The API notification messages are now displayed at the beginning of the API header.


October 17, 2022

What’s New

Mule 3.8 and 3.9 EOL messages are shown in API Manager for:

  • APIs running on Mule 3.8, which has already reached end of life and whose extended support ended on November 16, 2021.

  • APIs running on Mule 3.9, whose standard support ended on March 20, 2021.

Improved user experience over Flex 1.2.0 new features:

  • Adding port sharing validation.


September 28, 2022

What’s New

Flex Gateway information shown in API Manager has been enhanced as follows:

  • Flex Gateway data representation on API Manager charts is improved.

  • Message logs can now be viewed and downloaded in order from latest to oldest.

  • The message log streaming information now specifies log level, such as Info, Warn, and Error.


August 25, 2022

What’s New

The SLA Tiers, Contracts, and Client applications sections are improved for a better experience:

  • For SLA Tiers, the delete and deprecate actions are now found in the context menu at the end of each tier.

  • For Contracts:

    • The Pending tier change status is now named Approved (pending tier change). The current tier and requested tier can now be edited using the pencil icon without opening the application detail information.

    • The text in the column now changes from N/A to - when there is no current tier or requested tier.

    • The Refresh functionality is now added.

  • For Client applications:

    • The Pending contract column now shows the amount of pending contracts for each application.

    • Owners are now shown by email and not by name.

    • The Pending tag is now added to the drop-down options for APIs, API versions, API instances, group, group versions, and group instances to search for pending contracts easily.

Fixed Issues

  • For Contracts:

    • The Status filter now considers all contracts for the api and not just the contracts shown in the current view.

    • The Requested SLA tier can now be changed when a contract is in the Approve (pending tier change) status.


July 29, 2022

What’s New

  • API Manager now notifies you when policy implementations are incompatible with your current Flex Gateway version.

  • Applying a Message Logging policy to your API instance in API Manager allows you to view basic message logs for APIs managed by Flex Gateway within API Manager.


July 28, 2022

What’s New

  • You can now sort by the Error Rate and Total Requests columns in the API Manager API Administration page.


June 22, 2022

New Features

The alerts section has been improved for a better experience:

  • Clicking an alert will now show its details. To edit an alert, you can use the context menu icon.

  • Added an icon in the State column explaining each state in detail when you hover on it.


May 2, 2022

MuleSoft announces the release of API Manager 2.4.0.

New Features and Enhancements

The following new features and enhancements are introduced in API Manager 2.4.0:

  • You can now manage Flex Gateway APIs.

  • The new API Wizard introduces a streamlined way to create APIs.

  • Policy and automated policy management have been improved.

  • The release introduces a new way to create custom policies for Mule 4 and Flex Gateway.

  • The behavior of some policies has changed. For example, The IP Allowlist and IP Blocklist policies no longer accept a comma-separated list. The policies now accept data formatted as an array.

For details, see Anypoint API Manager.


August 12, 2021

MuleSoft announces the release of API Manager 2.3.0.

New Features and Enhancements

The following new features and enhancements are introduced in API Manager 2.3.0:

  • The API list view has been redesigned to enable quick glances at important information, without having to click into specific API instances.

  • In the redesigned API list, you can now view total requests and error rates for an API (for the previous 24 hours).

For details, see What Anypoint API Manager Is.


June 4, 2021

This release introduces the following enhancement:

  • Enhanced the UI to have the Mule 4 version selected by default for APIs.

  • Fixed bugs and implemented security improvements.


October 20, 2020

Fixed Issues

API proxies were responding with an unexpected HTTP status code when an API policy rejected an incoming HTTP Request.

Known Issues



May 30, 2020

This release introduces platform-wide support for API Groups across API Manager, Exchange, and API Community Manager, enabling you to package multiple API instances into a single cohesive unit for your API consumers.

API consumers can access the published API Groups from Anypoint Exchange and API Community Manager. For more information about this feature, see API Groups.

Fixed Issues


Known Issues



April 02, 2020

This release introduces support for multiple identity providers for client management. You can now assign different client identity providers to business groups, environments, and APIs.

Configuring multiple client providers enables you to enforce security and regulations in your business organization.

For more information about this feature, see Configuring Multiple Client Providers.


October 5, 2019

This release provides this new feature:

  • Support for WSDL and RAML payload validations for Mule 3 and Mule 4 proxy applications.
    See API Proxy Validations for more information.


May 4, 2019

This release provides this new feature:


April 6, 2019

This release provides this new feature:

  • Support for Mule 4 API proxy versions in API configuration

Fixed in This Release

  • Incorrect user information received in request api access email

  • Federated users unable to create APIs


Jan 26, 2019

This release provides this new feature:

  • Automated policy for Mule 4 APIs

  • Adding RAML support for "Create new API"

  • While creating an API instance, API version and asset version are prepopulated

  • When deploying Mule 4 to CloudHub it is possible to choose specific runtime version

  • Notification for a managed API if API spec changes or newer version available in Exchange


December 21, 2018

This release provides this new feature:

  • JWT policy for Mule 4 APIs


November 17, 2018

This release provides this new feature:

  • Domain support for Mule 4

Fixed in This Release

  • Bug when users download a HTTPS proxy without TLS context.

  • Changed policy display order, sorting version in descending order.


November 3, 2018

This release provides this new feature:

  • API Manager 2.x users will get access to Secrets Manager.

  • Configure, secure & deploy HTTPs proxies using certificates (keystore/truststore) stored in Secrets Manager. This feature will be available for Mule 4 APIs deployed to CloudHub & Hybrid deployment targets.


August 30, 2018

This release provides this new feature:

  • User-defined ports for CloudHub deployments

  • Added "Manage Runtime Fabric" proxy link

  • Auto populate implementation URI from Exchange

  • Support for Analytics chart to every granular permission

Fixed in This Release

  • Bug when users couldn’t add tags

  • Bug when users with custom roles weren’t receiving email notifications for API access


June 30, 2018

This release provides this new feature:

  • Caching Policy for Mule 4 APIs


June 2, 2018

This release provides this new feature:

  • Changes in platform APIs for unclassified environments to facilitate CI/CD pipelines.

Fixed in This Release

  • Bug when cannot save a change in API configuration. (AP-4030)

  • Bug when Mule 4 Runtime in a business group is unable to retrieve contracts. (AP-4081)


May 17, 2018

This release provides these features:

  • Fine-grained access control for the November release of API Manager 2.0.

  • Logging and Header injection and removal policy for 3.8.5+ runtimes.

  • On the API Settings page "Client Applications" has been renamed to "Contracts".

  • Bug fixes.

Fixed in This Release

  • Bug when displaying client ID enforcement details. (AP-3976)

  • Exporting a Mule 4 API containing a policy resulted in a "TypeError: Cannot read property" message. (AP-3941)

  • If a valid URL with OAuth was copied from API Manager, and the user then logged out, subsequent attempts to access the URL failed with an NPE. (AP-3907)

  • Redeploy button incorrectly disabled after a deploy. (AP-3955)

  • When a user only has Asset Admin permission in Anypoint Exchange, the action of making the API Instance public or private fails. (AP-3860)

  • Allow updating these fields, which were set to read-only after the November upgrade:, api.groupId (also updates the apiversion.groupId), api.assetId (also updates the apiversion.assetId), and (AP-4020)


April 23,2018

This release includes these improvements and bug fixes.

  • Support for 3.9 proxies.

  • Fixes an issue when approval email was not sent after requesting access for published APIs with manual approval.

  • Fixes an issue with autocomplete on import from Exchange.

  • Improved error message when deleting Client Applications with OKTA as the IM provider.

  • When autodiscovery looks for API ID that does not exist, Platform returns 403 instead of 404.


January 27, 2018

This release supports deployment for Mule 4.1.0 proxies on the November release.


November 18, 2017

This release of API Manager includes new and enhanced features for accounts that have upgraded to the November release. If your account hasn’t been upgraded yet, please contact your Customer Success representative.

Key Changes and Enhancements

  • A tight integration of Anypoint Platform components extends the use of environments to API management.

  • API permissions are now environment-based.

  • You can now create multiple instances of an API.

  • APIs in Exchange can be managed from API Manager.

  • There are two new APIs for managing APIs:

    • API Manager API v1.0 to manage API.

    • API Manager proxy API v1.0 to manage deployment of API proxies through API Manager.

  • Support for Mule 4 Early Access. Mule 4-related changes to API Manager are:

    • Classloader isolation exists between the application, the runtime and the connectors, and policies.

    • This release of Mule 4 changes the packaging, size, and scope of a policy.

    • All policies are non-blocking.

    • All policies except CORS, which is executed first, can be ordered.

  • Custom policy development has changed.

  • Header propagation no longer occurs by default and needs to be configured.

  • Resource level policy support, which was restricted to RAML-based APIs, is extended to any HTTP API.

  • API Manager does not support auto-generation and deployment of proxies.

  • The Throttling policy is not supported in this Mule release.

  • Mule 4 replaces the security manager policies with two HTTP Basic Authentication policies:

    • A combination of HTTP Basic Authentication and Simple Security Manager

    • A combination of HTTP Basic Authentication and LDAP Security Manager

      The policy protects an API by expecting and validating a user name and password.

  • You can configure the Rate Limiting policy if the quota is shared among the cluster nodes or not. By default, the quota is shared among the cluster nodes.