---
title: "Read your existing Vercel connection"
method: GET
path: "/auth/vercel/configuration/{configurationId}"
tags: ["Integrations"]
---

# Read your existing Vercel connection

`GET /auth/vercel/configuration/{configurationId}`

## Request

- Base URL: `https://api.pyai.com`
- URL: `https://api.pyai.com/auth/vercel/configuration/{configurationId}`
- Auth: API key in cookie `pyai_session`

Requires a signed-in PyAI console session and an allowed browser Origin. Available only when the Vercel integration is enabled. Key creation and disconnection require owner/admin project access.

## Response `200`

Connection metadata; credentials are never returned.

- object
  - `id` string, required
  - `status` 'pending' | 'exchanging' | 'ready' | 'installing' | 'connected' | 'failed' | 'disconnecting' | 'disconnected', required
  - `configuration_id` string, nullable, required
  - `team_id` string, nullable, required
  - `project_id` string, nullable, required
  - `vercel_project_id` string, nullable, required
  - `expires_at` integer, required
  - `scopes` string[], required
  - `next` string, uri
  - `environment_cleanup_required` boolean, required

## Other responses

- `400`: Invalid input or missing confirmation.
- `401`: Sign in required.
- `403`: Origin, role, or project access denied.
- `404`: Connection not found.
- `409`: Connection changed; refresh before continuing.
- `429`: Too many connection requests; retry later.
- `502`: Provider request failed; no automatic retry.
- `503`: Integration not enabled.

---

[API](https://skmtc.dev/pyai/apis/pyai-api.md) · [All operations](https://skmtc.dev/pyai/apis/pyai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pyai/apis/pyai-api/revisions/271a1539185b?raw)