anchor.diff:  ** Accepting the promotion will:
   *** Create or update the API (depending on if it has already been promoted or not)
   *** Remove the task.
  +
  +== Roles & Permission Required
  +Currently, the only required permission set necessary to promote an API is 'Definition.' Questions about roles and  permissions? See https://nightly-docs.gravitee.io/apim/3.x/apim_adminguide_roles_and_permissions.html#permission[Table 3, API Scope Permissions]. 
positive.code: 
  Here, we will see how to promote our API from environment `DEV` to environment `QA`.
  The following actions must be done with an API Publisher on `DEV` environment.
  
  . Go to the API to promote and click on image:icons/promote-button.png[role="icon"] *PROMOTE* button
  +
  
negative.code: 
  For a quick introduction on how to create an API in APIM, see link:/apim/3.x/apim_publisherguide_create_apis.html[Create an API^].
  
  NOTE: This feature is available from APIM 3.10.0 and requires your installation to be linked to Cockpit. For more information about Cockpit, see link:/cockpit/1.x/cockpit_overview_introduction.html[Cockpit]. 
  
  == Context
  
  * Two installations: 
  ** One linked to Demo and Production environments.
  ** Another one linked to Dev and QA environments.
  * An API to promote.
  +
  image::apim/3.x/api-publisher-guide/promote-apis/graviteeio-promote-api-cockpit-graph.png[Map of installations in Cockpit]
  
  