{
  "slug": "vercel-promote-rollback-redeploy-link-pull-env-and-domains-commands-support-json-23be14930459",
  "title": "vercel promote, rollback, redeploy, link, pull, env, and domains commands support --json",
  "tools": [
    "vercel"
  ],
  "tags": [
    "agent"
  ],
  "introduced_at": "2026-11-03T00:35:35.316Z",
  "announced_at": "2026-11-03T00:35:35.316Z",
  "effective_at": null,
  "date_basis": "source-publication",
  "status": "unknown",
  "how": {
    "incantation": "When a repository workflow needs machine-readable results for Vercel deployment or project configuration changes, pass `--json` to a supported command. Add `--yes` when confirmation is required; `vercel promote` waits between checks and stops at `--timeout` while a Rolling Release waits for its first stage.",
    "examples": [
      "vercel promote <deployment-id-or-url> --json [--yes] [--timeout <duration>]\nvercel promote status [project] --json",
      "vercel rollback <deployment-id-or-url> --json [--yes]\nvercel rollback status [project] --json\nvercel redeploy <deployment-id-or-url> --json [--yes]",
      "vercel link --json [--yes]\nvercel pull --json [--yes]\nvercel env add <name> <environment> --json [--yes]\nvercel env remove <name> <environment> --json [--yes]\nvercel domains add <domain> <project> --json [--yes]\nvercel domains remove <domain> --json [--yes]"
    ],
    "gotchas": [
      "Version: 65.10.0",
      "Non-interactive: `--json` does not prompt. A required confirmation still needs `--yes`; result documents go to stdout and error documents to stderr.",
      "--json: Emit one result document to stdout or one error document to stderr.",
      "--yes: Confirm when the command requires confirmation; JSON mode does not prompt.",
      "--timeout: Stop waiting after this duration for a Rolling Release's first stage.",
      "Prerequisite: Authenticate with a Vercel token for CI/CD use.",
      "Prerequisite: Install Vercel CLI with `pnpm i -g vercel`.",
      "`--json` never prompts; a confirmation still requires `--yes`.",
      "The `--timeout` behavior applies while a Rolling Release waits for its first stage."
    ]
  },
  "why_it_matters": "Automate deployment and project configuration changes from a repository workflow that needs machine-readable results.",
  "sources": [
    "https://vercel.com/docs/cli/release-notes#vercel@65.10.0",
    "https://vercel.com/docs/cli"
  ],
  "rank": 0.9505,
  "review_state": "approved",
  "provenance": {
    "run_id": "daily-20261103-05",
    "verdict_id": "daily-20261103-05:daily-20261103-05-ec7b6f38b9998961-1:gate",
    "evidence_hash": "95489ebd5da5867668891342ea4affe91b8884308cf22399b722ec733660b499"
  }
}
