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.
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.
