Deployment and stage

A deployment is a snapshot of your API configuration.

After you’ve updated your API configuration (resources, methods, integrations…), you must re-deploy your API to a stage so the changes is available for clients to invoke.

A stage is a named reference to a deployment of the API and is made available for client applications to call.

For each stage of your API, you can configure different settings
e.g. Cache, throttling, firewall/certificate settings…
For example, you can have dev, prod, v2 stages.

Under the hood, you deploy an API by creating a deployment and associating it with a stage.