CodePipeline

AWS CodePipeline is a continuous delivery service that automates the build, test, and deploy phases of software release pipelines. It orchestrates pipeline stages and actions, tracking execution status, source revisions, and approval steps across a release process.

With this integration, you can:

Inspect pipelines: List pipelines, retrieve a pipeline's stage and action structure, and check its current execution state
Track executions: Get details on a specific execution or list recent executions and action-level history, including status, triggers, and source revisions
Control pipeline flow: Start or stop executions, retry failed stages, and approve or reject pending manual approval actions
Manage stage transitions: Disable or re-enable artifact transitions into or out of a stage to freeze or resume a pipeline

In Zoen, the AWS CodePipeline integration allows your agents to monitor and control release pipelines programmatically — listing pipelines and their structure, checking execution and action status, starting or stopping executions, retrying failed stages, approving or rejecting manual approvals, and enabling or disabling stage transitions. This lets your agents build deployment automation and approval workflows that respond to pipeline state in real time.

Usage Instructions

Integrate AWS CodePipeline into workflows. Start, stop, and monitor pipeline executions, retry failed stages, and approve or reject manual approval actions. Requires AWS access key and secret access key.

Actions

`codepipeline_list_pipelines`

List all CodePipeline pipelines in an AWS account and region

Input

Parameter	Type	Required	Description
`awsRegion`	string	Yes	AWS region (e.g., us-east-1)
`awsAccessKeyId`	string	Yes	AWS access key ID
`awsSecretAccessKey`	string	Yes	AWS secret access key
`maxResults`	number	No	Maximum number of pipelines to return (1-1000)
`nextToken`	string	No	Pagination token from a previous call

Output

Parameter	Type	Description
`pipelines`	array	List of pipelines with name, version, type, and timestamps
↳ `name`	string	Pipeline name
↳ `version`	number	Pipeline version number
↳ `pipelineType`	string	Pipeline type (V1 or V2)
↳ `executionMode`	string	Execution mode (QUEUED, SUPERSEDED, PARALLEL)
↳ `created`	number	Epoch ms when the pipeline was created
↳ `updated`	number	Epoch ms when the pipeline was last updated
`nextToken`	string	Pagination token for the next page of results

`codepipeline_get_pipeline`

Get the structure of a CodePipeline pipeline, including its stages, actions, and variables

Input

Parameter	Type	Required	Description
`awsRegion`	string	Yes	AWS region (e.g., us-east-1)
`awsAccessKeyId`	string	Yes	AWS access key ID
`awsSecretAccessKey`	string	Yes	AWS secret access key
`pipelineName`	string	Yes	Name of the pipeline
`version`	number	No	Pipeline version to retrieve (defaults to the current version)

Output

Parameter	Type	Description
`pipelineName`	string	Pipeline name
`pipelineArn`	string	Pipeline ARN
`roleArn`	string	IAM role ARN the pipeline assumes
`version`	number	Pipeline version number
`pipelineType`	string	Pipeline type (V1 or V2)
`executionMode`	string	Execution mode (QUEUED, SUPERSEDED, PARALLEL)
`artifactStoreType`	string	Artifact store type (S3)
`artifactStoreLocation`	string	Artifact store bucket location
`stages`	array	Pipeline stages with their actions (name, category, provider, configuration)
↳ `stageName`	string	Stage name
↳ `actions`	array	Actions in the stage, in run order
`variables`	array	Pipeline variable declarations with default values
↳ `name`	string	Variable name
↳ `defaultValue`	string	Default value
↳ `description`	string	Variable description
`created`	number	Epoch ms when the pipeline was created
`updated`	number	Epoch ms when the pipeline was last updated

`codepipeline_get_pipeline_state`

Get the current state of a CodePipeline pipeline, including stage and action status and pending approval tokens

Input

Parameter	Type	Required	Description
`awsRegion`	string	Yes	AWS region (e.g., us-east-1)
`awsAccessKeyId`	string	Yes	AWS access key ID
`awsSecretAccessKey`	string	Yes	AWS secret access key
`pipelineName`	string	Yes	Name of the pipeline

Output

Parameter	Type	Description
`pipelineName`	string	Pipeline name
`pipelineVersion`	number	Pipeline version number
`created`	number	Epoch ms when the pipeline was created
`updated`	number	Epoch ms when the pipeline was last updated
`stageStates`	array	Per-stage state including latest execution status and action details
↳ `stageName`	string	Stage name
↳ `status`	string	Latest stage execution status (InProgress, Succeeded, Failed, Stopped, Cancelled)
↳ `pipelineExecutionId`	string	Pipeline execution ID currently in the stage
↳ `inboundTransitionEnabled`	boolean	Whether the inbound transition into the stage is enabled
↳ `actionStates`	array	Per-action state with status, summary, error details, and approval token (for pending manual approvals)

`codepipeline_get_pipeline_execution`

Get details of a CodePipeline execution, including status, trigger, source revisions, and resolved variables

Input

Parameter	Type	Required	Description
`awsRegion`	string	Yes	AWS region (e.g., us-east-1)
`awsAccessKeyId`	string	Yes	AWS access key ID
`awsSecretAccessKey`	string	Yes	AWS secret access key
`pipelineName`	string	Yes	Name of the pipeline
`pipelineExecutionId`	string	Yes	ID of the pipeline execution

Output

Parameter	Type	Description
`pipelineExecutionId`	string	Pipeline execution ID
`pipelineName`	string	Pipeline name
`pipelineVersion`	number	Pipeline version number
`status`	string	Execution status (Cancelled, InProgress, Stopped, Stopping, Succeeded, Superseded, Failed)
`statusSummary`	string	Status summary for the execution
`executionMode`	string	Execution mode (QUEUED, SUPERSEDED, PARALLEL)
`executionType`	string	Execution type (STANDARD or ROLLBACK)
`triggerType`	string	What triggered the execution (e.g., Webhook, StartPipelineExecution)
`triggerDetail`	string	Detail about the trigger (e.g., user ARN)
`artifactRevisions`	array	Source artifact revisions for the execution
↳ `name`	string	Artifact name
↳ `revisionId`	string	Revision ID (e.g., commit SHA)
↳ `revisionSummary`	string	Revision summary (e.g., commit message)
↳ `revisionUrl`	string	URL of the revision
↳ `created`	number	Epoch ms when the revision was created
`variables`	array	Resolved pipeline variables for the execution
↳ `name`	string	Variable name
↳ `resolvedValue`	string	Resolved variable value

`codepipeline_list_pipeline_executions`

List recent executions of a CodePipeline pipeline with status and source revisions

Input

Parameter	Type	Required	Description
`awsRegion`	string	Yes	AWS region (e.g., us-east-1)
`awsAccessKeyId`	string	Yes	AWS access key ID
`awsSecretAccessKey`	string	Yes	AWS secret access key
`pipelineName`	string	Yes	Name of the pipeline
`maxResults`	number	No	Maximum number of executions to return (1-100, default 100)
`nextToken`	string	No	Pagination token from a previous call
`succeededInStage`	string	No	Only return executions that succeeded in this stage

Output

Parameter	Type	Description
`executions`	array	Pipeline execution summaries, most recent first
↳ `pipelineExecutionId`	string	Pipeline execution ID
↳ `status`	string	Execution status (Cancelled, InProgress, Stopped, Stopping, Succeeded, Superseded, Failed)
↳ `statusSummary`	string	Status summary for the execution
↳ `startTime`	number	Epoch ms when the execution started
↳ `lastUpdateTime`	number	Epoch ms when the execution was last updated
↳ `executionMode`	string	Execution mode (QUEUED, SUPERSEDED, PARALLEL)
↳ `executionType`	string	Execution type (STANDARD or ROLLBACK)
↳ `stopTriggerReason`	string	Reason the execution was stopped, if applicable
↳ `triggerType`	string	What triggered the execution
↳ `triggerDetail`	string	Detail about the trigger
↳ `rollbackTargetPipelineExecutionId`	string	Execution ID this run rolled back to, if it was a rollback
↳ `sourceRevisions`	array	Source revisions (commit IDs, summaries, URLs) for the execution
`nextToken`	string	Pagination token for the next page of results

`codepipeline_list_action_executions`

List action-level execution history for a CodePipeline pipeline, including per-action status, timing, and error details

Input

Parameter	Type	Required	Description
`awsRegion`	string	Yes	AWS region (e.g., us-east-1)
`awsAccessKeyId`	string	Yes	AWS access key ID
`awsSecretAccessKey`	string	Yes	AWS secret access key
`pipelineName`	string	Yes	Name of the pipeline
`pipelineExecutionId`	string	No	Only return action executions for this pipeline execution
`maxResults`	number	No	Maximum number of action executions to return (1-100, default 100)
`nextToken`	string	No	Pagination token from a previous call

Output

Parameter	Type	Description
`actionExecutionDetails`	array	Action execution history, most recent first
↳ `pipelineExecutionId`	string	Pipeline execution ID
↳ `actionExecutionId`	string	Action execution ID (use as the approval token for PARALLEL execution-mode pipelines)
↳ `pipelineVersion`	number	Pipeline version number
↳ `stageName`	string	Stage the action belongs to
↳ `actionName`	string	Action name
↳ `startTime`	number	Epoch ms when the action started
↳ `lastUpdateTime`	number	Epoch ms when the action was last updated
↳ `updatedBy`	string	Who or what last updated the action
↳ `status`	string	Action execution status (InProgress, Abandoned, Succeeded, Failed)
↳ `externalExecutionId`	string	ID of the external system execution (e.g., CodeBuild build ID)
↳ `externalExecutionSummary`	string	Summary from the external system execution
↳ `externalExecutionUrl`	string	URL of the external system execution
↳ `errorCode`	string	Error code if the action failed
↳ `errorMessage`	string	Error message if the action failed
`nextToken`	string	Pagination token for the next page of results

`codepipeline_start_execution`

Start a CodePipeline pipeline execution, optionally overriding pipeline variables

Input

Parameter	Type	Required	Description
`awsRegion`	string	Yes	AWS region (e.g., us-east-1)
`awsAccessKeyId`	string	Yes	AWS access key ID
`awsSecretAccessKey`	string	Yes	AWS secret access key
`pipelineName`	string	Yes	Name of the pipeline to start
`clientRequestToken`	string	No	Idempotency token to identify a unique execution request
`variables`	json	No	Pipeline variable overrides as an array of { name, value } objects

Output

Parameter	Type	Description
`pipelineExecutionId`	string	ID of the pipeline execution that was started

`codepipeline_stop_execution`

Stop a CodePipeline pipeline execution, either finishing in-progress actions or abandoning them

Input

Parameter	Type	Required	Description
`awsRegion`	string	Yes	AWS region (e.g., us-east-1)
`awsAccessKeyId`	string	Yes	AWS access key ID
`awsSecretAccessKey`	string	Yes	AWS secret access key
`pipelineName`	string	Yes	Name of the pipeline
`pipelineExecutionId`	string	Yes	ID of the pipeline execution to stop
`abandon`	boolean	No	Abandon in-progress actions instead of letting them finish (default false)
`reason`	string	No	Reason for stopping the execution (max 200 characters)

Output

Parameter	Type	Description
`pipelineExecutionId`	string	ID of the pipeline execution that was stopped

`codepipeline_retry_stage_execution`

Retry the failed actions (or all actions) of a failed CodePipeline stage

Input

Parameter	Type	Required	Description
`awsRegion`	string	Yes	AWS region (e.g., us-east-1)
`awsAccessKeyId`	string	Yes	AWS access key ID
`awsSecretAccessKey`	string	Yes	AWS secret access key
`pipelineName`	string	Yes	Name of the pipeline
`stageName`	string	Yes	Name of the failed stage to retry
`pipelineExecutionId`	string	Yes	ID of the pipeline execution in the failed stage
`retryMode`	string	Yes	Scope of the retry: FAILED_ACTIONS or ALL_ACTIONS

Output

Parameter	Type	Description
`pipelineExecutionId`	string	ID of the pipeline execution with the retried stage

`codepipeline_put_approval_result`

Approve or reject a pending CodePipeline manual approval action. The approval token is available from Get Pipeline State on the pending approval action

Input

Parameter	Type	Required	Description
`awsRegion`	string	Yes	AWS region (e.g., us-east-1)
`awsAccessKeyId`	string	Yes	AWS access key ID
`awsSecretAccessKey`	string	Yes	AWS secret access key
`pipelineName`	string	Yes	Name of the pipeline
`stageName`	string	Yes	Name of the stage containing the approval action
`actionName`	string	Yes	Name of the manual approval action
`token`	string	Yes	Approval token from Get Pipeline State for the pending approval
`status`	string	Yes	Approval decision: Approved or Rejected
`summary`	string	Yes	Summary explaining the approval decision (max 512 characters)

Output

Parameter	Type	Description
`approvedAt`	number	Epoch ms when the approval or rejection was submitted
`status`	string	The submitted approval decision (Approved or Rejected)

`codepipeline_disable_stage_transition`

Prevent artifacts from transitioning into or out of a CodePipeline stage, freezing the pipeline at that point

Input

Parameter	Type	Required	Description
`awsRegion`	string	Yes	AWS region (e.g., us-east-1)
`awsAccessKeyId`	string	Yes	AWS access key ID
`awsSecretAccessKey`	string	Yes	AWS secret access key
`pipelineName`	string	Yes	Name of the pipeline
`stageName`	string	Yes	Name of the stage to disable the transition for
`transitionType`	string	Yes	Inbound to block artifacts entering the stage, Outbound to block artifacts leaving it
`reason`	string	Yes	Reason the transition is disabled, shown in the pipeline console (max 300 characters)

Output

Parameter	Type	Description
`pipelineName`	string	Pipeline name
`stageName`	string	Stage whose transition was disabled
`transitionType`	string	Transition type that was disabled (Inbound or Outbound)

`codepipeline_enable_stage_transition`

Re-enable artifacts transitioning into or out of a CodePipeline stage after it was disabled

Input

Parameter	Type	Required	Description
`awsRegion`	string	Yes	AWS region (e.g., us-east-1)
`awsAccessKeyId`	string	Yes	AWS access key ID
`awsSecretAccessKey`	string	Yes	AWS secret access key
`pipelineName`	string	Yes	Name of the pipeline
`stageName`	string	Yes	Name of the stage to enable the transition for
`transitionType`	string	Yes	Inbound to allow artifacts entering the stage, Outbound to allow artifacts leaving it

Output

Parameter	Type	Description
`pipelineName`	string	Pipeline name
`stageName`	string	Stage whose transition was enabled
`transitionType`	string	Transition type that was enabled (Inbound or Outbound)

CodePipeline

On this page