Sign in
Environments

Modify an existing environment.

put/environments/{environmentId}

Path parameters

environmentIdstring required

Request body

AllowDynamicInfrastructureboolean
Descriptionstring
EnvironmentIdstring required
EnvironmentTagsstring[]
Namestring required
Slugstring
SortOrderinteger
SpaceIdstring required
UseGuidedFailureboolean

Example request

{
  "EnvironmentId": "Environments-1",
  "SpaceId": "Spaces-1"
}

Response

The environment after modifications have been applied.

AllowDynamicInfrastructureboolean

If set to true, deployments to this environment will be allowed to contain steps that manage infrastructure. This relies on DeploymentActionResource being set to allow managing resource for a step

Descriptionstring

Gets or sets a short description of this environment that can be used to explain the purpose of the environment to other users. This field may contain markdown.

EnvironmentTagsstring[]

List of tags assigned to this environment

Idstring

Gets or sets a unique identifier for this resource.

LastModifiedBystring

Gets or sets the username of the user who last modified this resource.

LastModifiedOnstring date-time

Gets or sets the date/time that this resource was last modified.

Linksobject

Gets or sets a dictionary of links to other related resources. These links can be used to navigate the resources on the server.

Namestring

Gets or sets the name of this environment. This should be short, preferably 5-20 characters.

Slugstring
SortOrderinteger

Gets or sets a number indicating the priority of this environment in sort order. Environments with a lower sort order will appear in the UI before items with a higher sort order.

SpaceIdstring
UseGuidedFailureboolean

If set to true, deployments will prompt for manual intervention (Fail/Retry/Ignore) when failures are encountered in activities that support it. May be overridden with the Octopus.UseGuidedFailure special variable.

Example response

{
  "SpaceId": "Spaces-1"
}

Changes