Support for OpenAPI (previously Swagger) API Descriptions

You can now create an API resource based on an API description that you have uploaded from a file written in a supported language. Currently, OpenAPI Specification version 2.0 (formerly Swagger Specification 2.0) and version 3.0 are supported.

An API description defines an API resource, including:

  • available endpoints
  • available operations on each endpoint
  • parameters that can be input and output for each operation
  • authentication methods

If you use an API resource to deploy an API on an API gateway, its API description pre-populates some of the properties of the API deployment specification.

For more information, see Creating an API Resource with an API Description.