// Lifecycles

Add a lifecycle phase

Append a phase to a lifecycle.

POST/api/lifecycle/phase

Description

Adds a phase to a lifecycle. The phase is appended at the end unless sortOrder is provided.

Each phase environment has a howToTrigger mode: Automatic, Manual, or RequiresApproval.

Parameters

NameInTypeRequiredDescription
lifecycleId body string yes ID of the lifecycle.
name body string yes Phase name.
description body string no Optional description.
sortOrder body number no Position. Defaults to end.
progressRequirement body string no AllMustComplete (default), AnyMustComplete, or Count.
progressRequirementCount body number no Required only when progressRequirement = Count.
progressRequirementErrorMode body string no How errors / warnings should be treated when checking progress.
environments body array<object> no List of { environmentId, howToTrigger }.

Errors

StatusMeaning
400 Invalid lifecycleId, validation failure, or referenced environment not in the workspace.
401 Missing or invalid Basic auth credentials, or the service account lacks the required role.