---
title: "Start a Vercel connection"
method: POST
path: "/auth/vercel/start"
tags: ["Integrations"]
---

# Start a Vercel connection

`POST /auth/vercel/start`

## Request

- Base URL: `https://api.pyai.com`
- URL: `https://api.pyai.com/auth/vercel/start`
- 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`

One-use external installation URL.

- object
  - `url` string, uri

## 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/819d8e7c4d09?raw)