[cli] Add --id flag to build and env pull for deployment-scoped env vars by ofhouse · Pull Request #15805 · vercel/vercel

ofhouse · 2026-04-01T14:32:50Z

Context

For the BYOC workflow, vercel build needs access to the same environment variables that the build-container receives. Currently it loads env vars from local .env files created by vercel pull, which miss deployment-specific vars (integration overrides, system vars like VERCEL_URL/VERCEL_DEPLOYMENT_ID, LaunchDarkly flags, etc.).

This adds --id support to both vercel build and vercel env pull so they can fetch the fully resolved env vars stored on a specific deployment.

Changes

Added --id flag to vercel build — when provided, fetches buildEnv from the deployment via the env pull API instead of loading from local .env files. Polls if integrations are still provisioning (checks integrationsStatus in the error response, 5s interval, 3min timeout matching the API).
Added --id flag to vercel env pull — when provided, fetches env from the deployment in one shot (no polling). Writes to file same as before.
Updated pullEnvRecords() to accept deployment IDs — skips target/gitBranch path segments when the ID starts with dpl_.
Added telemetry tracking for the new --id option in both commands.

References

Depends on vercel/api#66324 (API-side: extends pull-env-vars endpoint to accept deployment IDs)

changeset-bot · 2026-04-01T14:32:57Z

🦋 Changeset detected

Latest commit: 3c38cfb

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package

Name	Type
vercel	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

github-actions · 2026-04-01T14:34:34Z

📦 CLI Tarball Ready

The Vercel CLI tarball for this PR is now available!

Quick Test

You can test this PR's CLI directly by running:

npx https://vercel-b2n2zalyx.vercel.sh/tarballs/vercel.tgz --help

Use in vercel.json

To use this CLI version in your project builds, add to your vercel.json:

{
  "build": {
    "env": {
      "VERCEL_CLI_VERSION": "vercel@https://vercel-b2n2zalyx.vercel.sh/tarballs/vercel.tgz"
    }
  }
}

Python Runtime Wheel

A vercel-runtime wheel was also built for this PR.
To use in your Python project builds, also set this environment variable:

VERCEL_RUNTIME_PYTHON="vercel-runtime @ https://vercel-b2n2zalyx.vercel.sh/tarballs/vercel_runtime-0.13.0.dev1775228301+29fb7ce-py3-none-any.whl"

Python Workers Wheel

A vercel-workers wheel was also built for this PR.
To use in your Python project builds, also set this environment variable:

VERCEL_WORKERS_PYTHON="vercel-workers @ https://vercel-b2n2zalyx.vercel.sh/tarballs/vercel_workers-0.1.0.dev1775228301+29fb7ce-py3-none-any.whl"

github-actions · 2026-04-01T14:34:35Z

🧪 Unit Test Strategy

Comparing: d034d90 → 3c38cfb (view diff)

Strategy: Code changed outside of a package - running all unit tests

⚠️ All unit tests will run because global code changes could impact all packages.

Affected packages - 15 (38%)

vercel
@vercel/build-utils
@vercel/client
@vercel/firewall
@vercel/fs-detectors
@vercel/go
@vercel/hydrogen
@vercel/next
@vercel/node
@vercel/python
@vercel/remix-builder
@vercel/ruby
@vercel/rust
@vercel/static-build
examples

Unaffected packages - 25 (63%)

@vercel-internals/get-package-json
@vercel/backends
@vercel/cervel
@vercel/cli-auth
@vercel/config
@vercel/detect-agent
@vercel/edge
@vercel/elysia
@vercel/error-utils
@vercel/express
@vercel/fastify
@vercel/frameworks
@vercel/functions
@vercel/gatsby-plugin-vercel-builder
@vercel/h3
@vercel/hono
@vercel/koa
@vercel/nestjs
@vercel/oidc
@vercel/oidc-aws-credentials-provider
@vercel/python-analysis
@vercel/redwood
@vercel/related-projects
@vercel/routing-utils
@vercel/static-config

Results

Unit tests: All affected packages will run unit tests
E2E tests: Running in parallel via E2E Tests workflow
Type checks: All affected packages will run type checks

This comment is automatically generated based on the affected testing strategy

vercel · 2026-04-01T14:35:08Z

Low Risk — CLI feature addition — new optional --id flag for fetching deployment-scoped env vars.

command.ts: added --id flag definition to build and env pull commands
build/index.ts: fetch env vars from deployment API when --id provided, with polling for integrations
get-env-records.ts: skip target/gitBranch path segments when ID starts with dpl_

^{Assessed at 3c38cfb.}

packages/cli/src/commands/build/index.ts

…env keys

… env vars

This PR was opened by the [Changesets release](https://github.com/changesets/action) GitHub action. When you're ready to do a release, you can merge this and the packages will be published to npm automatically. If you're not ready to do a release yet, that's fine, whenever you add more changesets to main, this PR will be updated. # Releases ## [email protected] ### Minor Changes - Add `vercel tokens` subcommands (`ls`, `add`, `rm`) for auth token API parity with the dashboard. ([#15812](#15812)) - Add `vercel project access-summary` subcommand to list member counts by role for a project. ([#15813](#15813)) - Add `vercel project members` and `vercel project access-groups` commands, and fix `vercel teams members` to fetch all pages from the paginated team members API. ([#15786](#15786)) ### Patch Changes - Add `--id` flag to `vercel build` and `vercel env pull` to fetch deployment-scoped environment variables ([#15805](#15805)) - Updated dependencies \[]: - @vercel/[email protected] ## @vercel/[email protected] ### Minor Changes - Add Mastra framework preset ([#15076](#15076)) ## @vercel/[email protected] ### Patch Changes - Updated dependencies \[[`d034d90dcf78316ddacdcce8fd51329fb7eefe82`](d034d90)]: - @vercel/[email protected] Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

[cli] Add --id flag to build and env pull for deployment-scoped env vars

1a8cdd7

vercel bot deployed to Preview April 1, 2026 14:34 View deployment

healeycodes reviewed Apr 2, 2026

View reviewed changes

packages/cli/src/commands/build/index.ts Outdated Show resolved Hide resolved

healeycodes reviewed Apr 2, 2026

View reviewed changes

packages/cli/src/commands/build/index.ts Outdated Show resolved Hide resolved

healeycodes approved these changes Apr 2, 2026

View reviewed changes

Use explicit timeout loop guard and show spinner only once

4abf6f3

vercel bot deployed to Preview April 2, 2026 15:51 View deployment

[cli] Use buildEnv for deployment-scoped env pull to avoid encrypted …

cd8ea81

…env keys

vercel bot deployed to Preview April 2, 2026 16:06 View deployment

[cli] Set team context for deployment env fetch in vercel build --id

1d196f9

vercel bot deployed to Preview April 3, 2026 14:50 View deployment

vercel bot deployed to Preview April 3, 2026 14:55 View deployment

[cli] Suppress system env warning when build --id provides deployment…

29fb7ce

… env vars

ofhouse force-pushed the ofhouse/build-env-pull-deployment-id branch from 3dfd1e8 to 29fb7ce Compare April 3, 2026 14:58

vercel bot deployed to Preview April 3, 2026 14:59 View deployment

[cli] Update env pull help snapshot for --id flag

3c38cfb

vercel bot deployed to Preview April 3, 2026 15:25 View deployment

ofhouse marked this pull request as ready for review April 3, 2026 15:54

ofhouse requested review from a team as code owners April 3, 2026 15:54

ofhouse merged commit 16f663a into main Apr 3, 2026
243 of 245 checks passed

ofhouse deleted the ofhouse/build-env-pull-deployment-id branch April 3, 2026 16:23

vercel-cli-release-bot mentioned this pull request Apr 3, 2026

Version Packages #15820

Merged

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

[cli] Add --id flag to build and env pull for deployment-scoped env vars#15805

[cli] Add --id flag to build and env pull for deployment-scoped env vars#15805
ofhouse merged 6 commits intomainfrom
ofhouse/build-env-pull-deployment-id

ofhouse commented Apr 1, 2026 •

edited

Loading

Uh oh!

changeset-bot bot commented Apr 1, 2026 •

edited

Loading

Uh oh!

github-actions bot commented Apr 1, 2026 •

edited

Loading

Uh oh!

github-actions bot commented Apr 1, 2026 •

edited

Loading

Uh oh!

vercel bot commented Apr 1, 2026 •

edited

Loading

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Conversation

ofhouse commented Apr 1, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Context

Changes

References

Uh oh!

changeset-bot bot commented Apr 1, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🦋 Changeset detected

Uh oh!

github-actions bot commented Apr 1, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

📦 CLI Tarball Ready

Quick Test

Use in vercel.json

Python Runtime Wheel

Python Workers Wheel

Uh oh!

github-actions bot commented Apr 1, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🧪 Unit Test Strategy

Results

Uh oh!

vercel bot commented Apr 1, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

ofhouse commented Apr 1, 2026 •

edited

Loading

changeset-bot bot commented Apr 1, 2026 •

edited

Loading

github-actions bot commented Apr 1, 2026 •

edited

Loading

github-actions bot commented Apr 1, 2026 •

edited

Loading

vercel bot commented Apr 1, 2026 •

edited

Loading