Contact Us 1-800-596-4880

API Gateway Runtime 2.0 Release Notes

MuleSoft is pleased to announce the 2.0 release of the API Gateway runtime. This release includes support for the new high-performance HTTP Connector and enhanced analytics tracking capabilities when using the on premises version of the Anypoint Platform. The release also includes bug fixes and performance improvements.


  • ESB Runtime 3.7

  • APIKit 1.7

  • Anypoint Studio 5.2

New Features

Fixed In This Release

  • AGW-327 - 403 HTTP code (forbidden) when OAuth access token key is empty.

  • AGW-424 - Have a separate thread for fetching policies and for activating api endpoints

  • SE-2099 - API Gateway | HTTP query.param truncated by ';' character

  • SE-1904 - Can’t manage multiple "Set-Cookie" headers

  • SE-1775 - HTTP Outbound call gets 404 on API Gateway, but 200 on Mule ESB

  • SE-1545 - OAuth enforcement absorbs CORS preflight calls

Deprecated in this Release

  • With the HTTP listener support, the old endpoint based version of the HTTP connector is no longer supported in 2.0. Use the migration tool for existing proxies.

  • Use register-as when defining autodiscovery for endpoints removed from the schema.

Migration Guide

  1. Modify and migrate all deployed applications and proxies to use the new HTTP listener used in the 2.0 runtime. For automatically generated (but not modified) proxies of versions 1.3.X or older, there is a migration tool. However, custom apps or post-generation modified proxies will need to be manually modified and re-deployed.

  2. Custom policies continue to work. However as-is if policy violations occur, these are not reported to analytics as such events need to include their ID. To ensure that violations are reporting, the policy needs to be modified to include an ID. See Applying Custom Policies for examples of both runtimes.

Known Issues

If you need to edit a proxy in Anypoint Studio (typically to include HTTPS credentials), you can’t perform an auto-deploy directly from the Anypoint Studio UI to CloudHub. You must first export your Mule project as a .zip file and then manually upload it to your CloudHub account. This procedure will be simplified with the next update site of Anypoint Studio, scheduled to be released in July.

See Also