// Lifecycles

Get lifecycle details

Retrieve one lifecycle by ID.

GET/api/lifecycle/details

Description

Returns one lifecycle: its name, description, ordered phases, and the environments in each phase.

The lifecycle ID identifies its workspace, so no workspaceId is required.

Phase fields - progressRequirement, progressRequirementErrorMode, progressRequirementCount, and howToTrigger - are described in Add a lifecycle phase.

Parameters

Name	In	Type	Required	Description
`lifecycleId`	query	string	yes	ID of the lifecycle.

Errors

Status	Meaning
`400`	Missing or unknown `lifecycleId`.
`401`	Missing or invalid Basic auth credentials, or the service account cannot manage lifecycles in this workspace.

Request

GET /api/lifecycle/details?lifecycleId=lc_1 HTTP/1.1
Authorization: Basic <base64(serviceAccountId:apiKey)>

Response

{
  "lifecycleId": "lc_1",
  "workspaceId": "ws_abc",
  "name": "default",
  "description": "Standard promotion path",
  "phases": [
    {
      "phaseId": "ph_1",
      "name": "Dev",
      "description": null,
      "sortOrder": 1,
      "progressRequirement": "AllMustComplete",
      "progressRequirementErrorMode": "NoErrorsNoWarnings",
      "progressRequirementCount": 0,
      "environments": [
        { "environmentId": "env_a", "environmentName": "Development", "howToTrigger": "Automatic" }
      ]
    },
    {
      "phaseId": "ph_2",
      "name": "Staging",
      "description": "Sign-off before production",
      "sortOrder": 2,
      "progressRequirement": "MinimumNumberToComplete",
      "progressRequirementErrorMode": "NoErrorsAllowWarnings",
      "progressRequirementCount": 1,
      "environments": [
        { "environmentId": "env_b", "environmentName": "Staging EU", "howToTrigger": "Manual" },
        { "environmentId": "env_c", "environmentName": "Staging US", "howToTrigger": "Manual" }
      ]
    }
  ]
}