Sign in
Environments

Get a list of Environments

Lists the name and ID of all of the environments in the supplied Space. The results will be sorted by the SortOrder field on each environment.

get/environments/all

Query parameters

channelIdstring

A Channel Id used to filter a query.

idsstring[]

A comma separated list of Deployment Environment resource ids used to filter a query.

projectIdstring

A project Id used to filter a query.

Response

Requested list of Environments

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

No recorded changes to this endpoint across all 6 revisions of this API.