Expression Objects Reference
Available objects for use in ${{ }} expressions.
These objects provide access to pipeline and deployment context.
Quick Reference
| Object | Description |
|---|---|
stage | Information about the current deployment stage |
pipeline | Information about the current pipeline |
organization | Information about the organization |
trigger | Information about the deployment trigger, including git commit and branch context |
vars | Stage-level variables defined in the pipeline |
steps | Reference outputs from other steps in the same stage |
Objects
stage
Information about the current deployment stage.
Properties
| Property | Type | Description |
|---|---|---|
name | string | The name of the current stage (e.g., "Build", "staging", "production") |
account_id | string | The AWS account ID for this stage deployment target |
region | string | The AWS region for this stage deployment target |
artifacts (indexable) | Record<string, ArtifactMetadata> | Artifacts available in this stage, keyed by artifact name. Each artifact has properties like image_url, image_tag, or s3_url depending on type. |
secrets (indexable) | Record<string, string> | Stage-scoped secrets. Access by secret name. Returns a deferred marker that is resolved at build-plane. |
Examples
stage.name
stage.account_id
stage.region
stage.artifacts["Docker Build"].image_url
stage.artifacts["My Bundle"].s3_url
stage.secrets["DB_PASSWORD"]
stage.secrets["API_KEY"]
pipeline
Information about the current pipeline.
Properties
| Property | Type | Description |
|---|---|---|
name | string | The display name of the pipeline |
slug | string | The URL-safe identifier of the pipeline |
pre_mirror_artifacts (indexable) | Record<string, ArtifactMetadata> | Artifacts in the CICD account before mirroring to deployment targets. Keyed by artifact name. |
Examples
pipeline.name
pipeline.slug
pipeline.pre_mirror_artifacts["Docker Build"].image_url
organization
Information about the organization.
Properties
| Property | Type | Description |
|---|---|---|
name | string | The display name of the organization |
slug | string | The URL-safe identifier of the organization |
cicd_account_id | string | The CI/CD AWS Account ID of the organization |
cicd_account_region | string | The CI/CD AWS Account Region of the organization |
secrets (indexable) | Record<string, string> | Organization-level secrets. Access by secret name. Returns a deferred marker that is resolved at build-plane. |
Examples
organization.name
organization.slug
organization.secrets["STRIPE_API_KEY"]
organization.secrets["DATABASE_PASSWORD"]
trigger
Information about the deployment trigger, including git commit and branch context.
Properties
| Property | Type | Description |
|---|---|---|
sha | string | The full git commit SHA that triggered the deployment |
branch | string | The git branch name that triggered the deployment |
tag | string | The git tag that triggered the deployment (empty string if not a tag deploy) |
revision | number | The deployment revision number |
Examples
trigger.sha
trigger.branch
trigger.tag
trigger.revision
s3://bucket/${{ trigger.sha }}/bundle.zip
image:${{ trigger.sha }}
vars
Stage-level variables defined in the pipeline. Supports nested objects and arrays.
Properties
| Property | Type | Description |
|---|---|---|
* (indexable) | any | Any variable defined in the stage's vars field. Supports dot notation for nested access and bracket notation for arrays. |
Examples
vars.environment
vars.db.host
vars.db.port
vars.azs[0]
vars.config.endpoints.api
vars["special-key"]
steps
Reference outputs from other steps in the same stage. Access by step name (bracket notation) or step ID (dot notation).
Properties
| Property | Type | Description |
|---|---|---|
* (indexable) | Record<string, any> | Step outputs keyed by step name or ID. Each step's output is an object with fields defined by the step type. |
Examples
steps["Synthesize Infrastructure"].vpc_id
steps.infra.vpc_id
steps.infra.ecs_cluster_name
steps["Deploy ECS"].service_arn
steps.terraform.outputs.bucket_name