Skip to content
GET
200
404
POST
201
400
403
API reference
Operator - Workflow Promotions
One tag: method, path, summary, auth, and scopes. Request and response fields ship in this page — expand a row to read the contract.
Endpoints
2
GET
/api/v1/operator/workflow_targets/:workflow_target_id/promotions
Web Session
Get workflow promotion state
/api/v1/operator/workflow_targets/:workflow_target_id/promotions
Web Session
Get workflow promotion state
Description
Returns environment-to-version assignments and recent promotion history for a workflow target.
Auth
Web SessionParameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| workflow_target_id | path | string | Yes | Workflow target UUID |
Responses
200
Promotion state for workflow target
Returns: WorkflowPromotionState
Promotion state for workflow target
Returns: WorkflowPromotionState
404
Workflow target not found
Workflow target not found
POST
/api/v1/operator/workflow_targets/:workflow_target_id/promotions
Web Session
Promote workflow version
/api/v1/operator/workflow_targets/:workflow_target_id/promotions
Web Session
Promote workflow version
Description
Promotes a workflow version to a target environment and records promotion history.
Auth
Web SessionRequest Body
| Field | Type | Required | Description |
|---|---|---|---|
| note | string | No | Promotion note |
| workflow_version_id | string | Yes | Workflow version UUID to promote |
| from_environment | string (development, staging, production) | No | Source environment |
| to_environment | string (development, staging, production) | Yes | Destination environment |
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| workflow_target_id | path | string | Yes | Workflow target UUID |
Responses
201
Promotion completed
Returns: WorkflowPromotionResult
Promotion completed
Returns: WorkflowPromotionResult
400
Invalid promotion payload
Invalid promotion payload
403
Unauthorized
Unauthorized