Vercel

Writes

• Redeploy

  read back

  vercel-redeploy

  Start a new build of an existing deployment, with the project's current settings and environment variables. Pass target=production to build it for production; without it the new deployment is a preview. Returns the new deployment with its id and readyState.

• Promote deployment

  read back

  vercel-promote-deployment

  Point a project's production domains at an existing production deployment, without rebuilding it: a staged build that has not served production yet, or, after a rollback, the deployment to restore. Promoting after a rollback undoes it and turns Vercel's assignment of production domains to new builds back on. To put a preview build in production, use redeploy with target=production.

• Rollback deployment

  read back

  vercel-rollback-deployment

  Instant Rollback: point a project's production domains back at an earlier deployment that served production before. It does not rebuild, so that deployment keeps the environment variables it was built with. On the Hobby plan, the target must be the deployment just before the current one.

• Cancel deployment

  read back

  vercel-cancel-deployment

  Cancel a deployment that is queued or building. Vercel refuses one that has already finished.

• Delete deployment

  acknowledged

  vercel-delete-deployment

  Delete one deployment. Its URLs stop serving it, and it cannot be restored. Returns the deployment's uid and state DELETED.

Reads

• List teams

  vercel-list-teams

  List the teams the token can reach, 20 per page, with each team's id, slug and name. Every other action needs a team id from here; a Hobby account is listed as a team too. Vercel returns pagination.next when there are more; pass it as until for the next page.

• List deployments

  vercel-list-deployments

  List a team's deployments, newest first, 20 per page: uid, name (the project), url, state, target, projectId, created time, creator and Git metadata. Filter by project, target, state, branch or commit. Vercel returns pagination.next when there are more; pass it as until for the next page.

• Get deployment

  vercel-get-deployment

  Get one deployment: readyState, target, url, aliases, the error code and message of a failed build, the Git source, creator, regions and timings. It lists the names of the environment variables the build had, never their values. A deployment with a very large route table can be cut at 64 KB.

• List deployment events

  vercel-list-deployment-events

  Read a deployment's build log: up to 50 events, oldest first, or newest first with direction=backward. Each event has a type, a created time in milliseconds and its text. For the next page, pass the last event's created time as since (oldest first) or until (newest first). It never follows a live build: call it again for new lines.

• List deployment aliases

  vercel-list-deployment-aliases

  List the aliases assigned to one deployment: each hostname (custom domains and vercel.app URLs), its uid and when it was created.

• List project domains

  vercel-list-project-domains

  List a project's domains, 20 per page: name, Git branch, redirect, whether it is verified, and the TXT records still needed to verify it. Pass production=true for production domains only. Vercel returns pagination.next when there are more; pass it as until for the next page.

• Get domain config

  vercel-get-domain-config

  Check how a domain is set up for Vercel: misconfigured (true when its DNS does not point at Vercel), configuredBy (A, CNAME, http or dns-01), and the recommended CNAME and A records.

• Get alias

  vercel-get-alias

  Get one alias by its hostname (www.example.com) or its uid: the deployment it serves (deploymentId), its project and when it was created. Use it on a production domain to see which deployment is live.

• List promote aliases

  vercel-list-promote-aliases

  List the aliases of a project's latest promote, 20 per page, with each alias's status. Use it after promote-deployment to see which domains have moved. Pass failed_only=true for the ones that failed. Vercel returns pagination.next when there are more; pass it as until for the next page.