Promotion refers to moving API Gateway assets from the source stage to one or more target stages. For example, you might want to promote assets you have developed on servers in a Development stage (the source API Gateway instance) to servers in a QA or Production stage (the target API Gateway instance).

When you promote an asset from one stage to another, the asset's metadata is copied from the source instance to the target instance.