> For the complete documentation index, see [llms.txt](https://codemash.gitbook.io/codemash/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://codemash.gitbook.io/codemash/api-reference/account/projects/promote-environment.md).

# Promote Environment

promote Environment.

A **project** is the top-level container for everything in Norbix — environments, modules, and data. These endpoints create and configure projects.

Promotes the environment.

The result lists `IntegrationsToProvision`: managed Atlas Flex integrations that get a new database (`<target env>_<integrationId>`) in the target environment. Secrets are never copied — each environment keeps its own.

Promoting **into PROD** adds a PROD copy of each Flex integration listed there, and only PROD copies count against the plan's Flex limit. At the limit the real run is refused with `CM-ERRORS-DATABASE-026` (trial) or `CM-ERRORS-DATABASE-027` (paid plan) before anything changes. A dry run does not check the limit yet. Promoting into a non-PROD environment is never limited.

{% openapi src="/files/0gOkqzp7kyziG9XPpCBy" path="/{version}/account/projects/environments/promote" method="post" %}
[norbix-hub-swagger.json](https://712692422-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHy372bqsaex2cqS3ikhL%2Fuploads%2Fgit-blob-7c7445e68689b62620e59cb01a3523deb46b865b%2Fnorbix-hub-swagger.json?alt=media)
{% endopenapi %}

## In Cloud

Manage this visually in Cloud — see [Account & Projects](/codemash/cloud/project.md).

## Use it from code

Every Norbix SDK exposes this endpoint as a method — see [Promote Environment](/codemash/sdks/account/projects/promote-environment.md) in the SDK reference, with examples in every language.