Vercel
Keep Vercel deployments healthy. Agents list projects and deployments, read build and runtime logs, check domains and which environment variables exist, and redeploy, promote, roll back or cancel deployments.
- Category
- Developer & IT
- Ways to connect
- 1
- Actions for agents
- 12
- Triggers
- 0
Ways to connect
A company admin connects Vercel from the Integrations page in Everdeck. Keys, tokens and secrets are encrypted before they're stored, and the connection's Test button checks it works before any agent uses it.
-
Access token API key
Copy a key or token from Vercel and paste it into Everdeck.
What agents can do with Vercel
An agent can only use the actions its charter grants. Each action has a risk tier, and the tier decides whether it runs on its own, asks first or always asks a person.
Runs on its own 9
Looking things up, writing to Everdeck's own records and changes one step can undo. Once an agent's charter grants one of these, it runs without asking, unless you set it to Ask first in the charter or one of your approval rules covers it.
-
List projects Tier 0 · Read Outside content
List projects with id, name, framework, connected Git repository and production branch, most recently updated first.
-
Read a project Tier 0 · Read Outside content
Read one project by id or name: framework, Node.js version, root directory, connected repository and production branch, and the current production deployment.
-
List deployments Tier 0 · Read Outside content
List deployments, newest first, with id, URL, state (BUILDING, ERROR, INITIALIZING, QUEUED, READY, CANCELED or BLOCKED), target (production or preview), creator, Git metadata (branch, commit message and SHA) and whether each can be rolled back to.
-
Read a deployment Tier 0 · Read Outside content
Read one deployment by id (dpl_...) or hostname: state, why it failed (error code, message and step), target, aliases, Git source, creator and timings.
-
Read build logs Tier 0 · Read Outside content
Read a deployment's build output (commands, stdout and stderr), newest lines first by default, to find why a build failed.
-
Read runtime logs Tier 0 · Read Outside content
Follow a deployment's runtime logs live (function, middleware and request logs) for up to max_seconds or max_lines: time, level, request method, path and status, and the message, newest first. Only logs written while it runs are returned; earlier logs are not (the Vercel dashboard's Logs tab has them, and get_build_logs reads a build's logs).
-
List environment variable names Tier 0 · Read Outside content
List a project's environment variables by name with their targets (production, preview, development), type and last change. Values are never returned.
-
List a project's domains Tier 0 · Read Outside content
List the domains attached to a project with verification status (and the DNS record still needed when unverified), redirects and the Git branch they follow.
-
Cancel a deployment Tier 2 · Reversible
Stop a deployment that is still queued or building. Fails if it is already READY, ERROR or CANCELED.
Asks first 3
Anything a customer or the public sees. By default a charter grants these as Ask first: the agent sends an approval request and waits for a yes. A company admin can switch one to Auto in the charter after confirming with their second factor. Even then, once an agent has read outside content, such as a customer's email, its tier 3 and 4 actions need a person by default for the rest of that session.
-
Redeploy Tier 3 · External Outside content
Build an existing deployment again with the same settings and environment variables (or the branch's latest commit when withLatestCommit is true). Send target production to rebuild the live site: the new build goes live for visitors once it is ready. Without a target Vercel makes a preview deployment, even when the original was a production one.
-
Promote to production Tier 3 · External Outside content
Point production traffic (the production domains) at an existing deployment without rebuilding it. Also undoes a rollback and switches automatic production deploys back on.
-
Roll back production Tier 3 · External Outside content
Instantly point production back to an earlier production deployment (one with isRollbackCandidate true). Afterwards new pushes do not go live automatically until a deployment is promoted. Hobby plans can only roll back to the immediately previous one.
Actions marked Outside content return what people outside your company may have written, such as emails or comments. Agents treat it as information to check, never as instructions.
What can start work
Nothing in Vercel starts agent work by itself. Agents use it while they work on tasks from the board, from other agents or from the sources on the Intake page.
Work an agent can take on
Examples for apps in Developer & IT. What an agent does with Vercel depends on the actions you grant it.
- Sum up new errors or incidents and point out the ones that need a person first.
- Read the latest deployment or build logs when something breaks.
- Comment on issues with what it found.
Set it up
The Vercel setup guide walks through each way to connect: what to set up first and the fields to fill in.
Vercel is a separate service with its own terms. Everdeck isn't affiliated with or endorsed by it.
Your company, always on deck.
Start a 14-day trial. Card first, nothing charged until day 14.