Amazon API Gateway
Developer Guide

Import a REST API into API Gateway

You can use the API Gateway Import API feature to import a REST API from an external definition file into API Gateway. Currently, the Import API feature supports OpenAPI v2.0 and OpenAPI v3.0 definition files.

With the Import API, you can either create a new API by submitting a POST request that includes an OpenAPI definition in the payload and endpoint configuration, or you can update an existing API by using a PUT request that contains an OpenAPI definition in the payload. You can update an API by overwriting it with a new definition, or merge a definition with an existing API. You specify the options using a mode query parameter in the request URL.


For RAML API definitions, you can continue to use API Gateway Importer.

Besides making explicit calls to the REST API, as described below, you can also use the Import API feature in the API Gateway console. For a quick start to using the Import API feature from the API Gateway console, see Build an API Gateway API from an Example.