Environments

RotateEnvironment

Triggers secret rotation for a Pulumi ESC environment. This evaluates all fn::rotate declarations in the environment definition and rotates the corresponding secrets in their external systems (e.g., rotating database passwords, API keys, or cloud credentials). Requires the secret rotation feature to be enabled for the organization. Returns 409 if the environment has been modified since it was last read.

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

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}/rotate
  • Auth: none declared

Path parameters

orgNamestring required

The organization name

projectNamestring required

The project name

envNamestring required

The environment name

Request body

pathsstring[] required

The paths of the secrets to rotate.

Response

OK

idstring required

The unique identifier for this rotation operation.

Changes

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