Integrations / Vercel
Vercel
Vercel: list projects, deployments, domains and environment variable names, and inspect a deployment.
5 actions
API key
5 read0 write
Calls api.vercel.com
Connect
const conn = await setu.connections.initiate({ userId: "user_1", toolkit: "vercel" });
console.log(conn.connectUrl); // show this to your user
await conn.waitUntilActive();Permissions requested
This toolkit uses a single credential and requests no scopes.
Actions
Get deploymentreadvercel.get_deploymentGet a deployment by ID or hostname: state, URL, target and creation time.
| Input | Type | Description | |
|---|---|---|---|
id_or_url | string | Required | Deployment ID (dpl_...) or hostname |
team_id | string | Optional | Team ID to act on behalf of (omit for the personal account) |
await setu.execute({
userId: "user_1",
action: "vercel.get_deployment",
input: {
"id_or_url": "<id_or_url>"
},
});List deploymentsreadvercel.list_deploymentsList recent deployments, optionally for one project, environment or state, newest first.
| Input | Type | Description | |
|---|---|---|---|
project_id | string | Optional | Project ID or name to filter by |
target | string | Optional | Environment, e.g. production |
state | string | Optional | Filter by state |
limit | integer | Optional | Maximum number of deployments |
team_id | string | Optional | Team ID to act on behalf of (omit for the personal account) |
await setu.execute({
userId: "user_1",
action: "vercel.list_deployments",
input: {},
});List domainsreadvercel.list_domainsList the domains registered with the Vercel account or team.
| Input | Type | Description | |
|---|---|---|---|
limit | integer | Optional | Maximum number of domains |
team_id | string | Optional | Team ID to act on behalf of (omit for the personal account) |
await setu.execute({
userId: "user_1",
action: "vercel.list_domains",
input: {},
});List environment variable namesreadvercel.list_env_var_namesList the names, types and targets of a project's environment variables. Values are not returned.
| Input | Type | Description | |
|---|---|---|---|
project | string | Required | Project ID or name |
team_id | string | Optional | Team ID to act on behalf of (omit for the personal account) |
await setu.execute({
userId: "user_1",
action: "vercel.list_env_var_names",
input: {
"project": "<project>"
},
});List projectsreadvercel.list_projectsList Vercel projects of the account or team, optionally filtered by name search.
| Input | Type | Description | |
|---|---|---|---|
search | string | Optional | Filter by project name |
limit | string | Optional | Maximum number of projects |
team_id | string | Optional | Team ID to act on behalf of (omit for the personal account) |
await setu.execute({
userId: "user_1",
action: "vercel.list_projects",
input: {},
});