Environments

RetractEnvironmentRevision

Retracts a specific revision of a Pulumi ESC environment, marking it as withdrawn. A retracted revision remains in the history but is no longer considered a valid version for use. The request body may include a reason for the retraction. The revision is identified by the version path parameter. Returns 204 on success with no response body.

post/api/preview/environments/{orgName}/{envName}/versions/{version}/retract

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/preview/environments/{orgName}/{envName}/versions/{version}/retract
  • Auth: none declared

Path parameters

orgNamestring required

The organization name

envNamestring required

The environment name

versionstring required

The revision version number

Request body

reasonstring

The reason for retracting the revision.

replacementinteger

The revision number to use as a replacement, if any.

Response

No Content

Changes

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