Menu
Amazon API Gateway
Developer Guide

Import an API into API Gateway

You can use the API Gateway Import API feature to import an API from an external definition file into API Gateway. Currently, the Import API feature supports Swagger v2.0 definition files.

With the Import API, you can either create a new API by submitting a POST request that includes a Swagger definition in the payload and endpoint configuration, or you can update an existing API by using a PUT request that contains a Swagger 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 .

Note

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.