> ## Documentation Index
> Fetch the complete documentation index at: https://opensre.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Vercel

> Connect Vercel so OpenSRE can check deployment status and runtime logs during incidents

## Overview

OpenSRE queries Vercel to retrieve deployment status and runtime logs — helping identify whether a recent deployment caused an incident or surface errors from serverless function executions.

## Prerequisites

* Vercel account with project access
* Vercel API token

## Setup

### Option 1: Interactive CLI

```bash theme={null}
opensre integrations setup vercel
```

Provide your API token (and optional team ID) when prompted.

### Option 2: Environment variables

Add to your `.env`:

```bash theme={null}
VERCEL_API_TOKEN=your-vercel-api-token
VERCEL_TEAM_ID=team_xxxxxxxxx   # optional, for team accounts
```

| Variable | Default | Description |
| - | - | - |
| `VERCEL_API_TOKEN` | — | **Required.** Vercel API token |
| `VERCEL_TEAM_ID` | — | Team ID for team/organization accounts |

### Option 3: Persistent store

```json theme={null}
{
  "version": 1,
  "integrations": [
    {
      "id": "vercel-prod",
      "service": "vercel",
      "status": "active",
      "credentials": {
        "api_token": "your-vercel-api-token",
        "team_id": "team_xxxxxxxxx"
      }
    }
  ]
}
```

## Credentials

1. In Vercel, go to **Account Settings** → **Tokens**
2. Click **Create Token**
3. Give it a name (for example `opensre`) and set the scope to **Full Account** or a specific team
4. Copy the token

> [!NOTE]
>
> For team accounts, find your Team ID in **Team Settings** → **General** → **Team ID**. Set `VERCEL_TEAM_ID` (or store `team_id`) so OpenSRE can list team projects.

OpenSRE calls the Vercel API at `https://api.vercel.com`.

## Tools

| Tool | What it does |
| - | - |
| `vercel_deployment_status` | Check recent deployment status for projects OpenSRE can see |
| `vercel_deployment_logs` | Retrieve runtime / deployment logs to surface serverless errors |

## Verify

```bash theme={null}
opensre integrations verify vercel
```

Expected output:

```
Service: vercel
Status: passed
Detail: Connected to Vercel API and listed 5 project(s)
```

Inside the REPL: `/integrations verify vercel` or `/verify vercel`.

## Troubleshooting

| Symptom | Fix |
| - | - |
| **401 Unauthorized** | Check that the API token is valid and not expired |
| **403 Forbidden** | The token may not have access to the team — check token scope |
| **Projects not found** | Ensure `VERCEL_TEAM_ID` is set if using a team account |

## Security

* Create a **dedicated read-only token** for OpenSRE — do not reuse deployment tokens.
* Store the token in `.env`, not in source code.
* Rotate tokens periodically.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.