Environments

CloneEnvironment

Creates a duplicate of a Pulumi ESC environment in a new project and/or under a new name. The request body specifies the destination project and environment name, along with options to control what is preserved during the clone: preserveAccess retains permission settings, preserveHistory retains the full revision history, preserveEnvironmentTags retains environment-level tags, and preserveRevisionTags retains version-specific tags. Environments cannot be renamed directly, so cloning is the mechanism for moving or renaming environments.

post/api/esc/environments/{orgName}/{projectName}/{envName}/clone

Request

  • Base URL: https://api.pulumi.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.pulumi.com/api/esc/environments/{orgName}/{projectName}/{envName}/clone
  • Auth: none declared

Path parameters

orgNamestring required

The organization name

projectNamestring required

The project name

envNamestring required

The environment name

Request body

namestring required

Name for the newly cloned environment.

preserveAccessboolean

Whether to copy access control settings from the source environment.

preserveEnvironmentTagsboolean

Whether to copy environment-level tags from the source environment.

preserveHistoryboolean

Whether to copy the revision history from the source environment.

preserveRevisionTagsboolean

Whether to copy revision-level tags from the source environment.

projectstring

Target project for the cloned environment. If omitted, uses the source project.

versioninteger

Specific version of the source environment to clone. If omitted, clones the latest version.

Response

No Content

Changes

No recorded changes to this operation across all 1 revision of this API.