---
title: "Get Connect Setup Status"
method: GET
path: "/chats/{chatId}/connect/status"
tags: ["Chats"]
---

# Get Connect Setup Status

`GET /chats/{chatId}/connect/status`

Polls the status of a Vercel Connect connector setup started by a `configure_vercel_connect` agent action. Open the `setupUrl` from the agent action data in a browser, then poll this endpoint every few seconds while `pending`. When it returns `ready`, resolve the chat with a `vercel-connect-setup` task to resume generation.

## Path parameters

- `chatId` string, required — The unique identifier of the chat.

## Query parameters

- `requestId` string, required — The `requestId` from the `configure_vercel_connect` agent action data.

## Response `200`

Response for status 200

- union
  - object
    - `status` 'pending', required — Setup is still in progress.
    - `progress` string — Current setup progress.
  - object
    - `status` 'ready', required — Setup completed successfully.
    - `connector` object, required — Connector created by setup.
      - `id` string, required — Vercel Connect connector identifier.
      - `uid` string — Optional connector UID.
      - `name` string, required — Connector display name.
      - `service` string — Connected service identifier.
      - `type` string, required — Connector type.
      - `supportedSubjectTypes` string[] — Subject types supported by the connector.
      - `supportsInstallation` boolean — Whether the connector supports installation.
      - `attachedToProject` boolean, required — Whether the connector is already attached to the project.
  - object
    - `status` 'error', required — Setup completed with an error.
    - `message` string, required — Safe user-facing setup error message.

## Other responses

- `401` — Response for status 401
- `403` — Response for status 403
- `404` — Response for status 404
- `409` — Response for status 409
- `422` — Response for status 422
- `500` — Response for status 500

---

[API](https://skmtc.net/vercel/apis/v0-platform-api-beta.md) · [All operations](https://skmtc.net/vercel/apis/v0-platform-api-beta/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vercel/v0-platform-api-beta/versions/7c7a496f8022/schema)