---
title: "Get Chat"
method: GET
path: "/chats/{chatId}"
tags: ["Chats"]
---

# Get Chat

`GET /chats/{chatId}`

Retrieves a chat by ID.

## Path parameters

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

## Response `200`

Response for status 200

- Chat
  - `id` string, required — Unique chat identifier.
  - `title` string — Chat title, if generated.
  - `privacy` 'public' | 'private' | 'team' | 'team-edit' | 'unlisted', required — Visibility setting of the chat.
  - `createdAt` string, date-time, required — ISO timestamp of when the chat was created.
  - `updatedAt` string, date-time — ISO timestamp of when the chat was last updated.
  - `authorId` string, required — ID of the user who created the chat.
  - `vercelProjectId` string — Associated Vercel project ID, if any.
  - `metadata` object, required — User-defined key-value metadata.
  - `writePermission` boolean, required — Whether the caller has write access to this chat.

## Other responses

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

## Changes

> 34 revisions in range; 3 could not be searched.

- **2026-07-30** `da68370a2aea` — 15 breaking, 6 warning, 15 info
  - for the `path` request parameter `chatId`, the minLength was increased from `0` to `1`
  - removed the required property `apiUrl` from the response with the `200` status
  - removed the required property `error` from the response with the `401` status
  - removed the required property `error` from the response with the `403` status
  - …32 more
- **2026-07-21** `b53921245779` — 1 warning
  - added the new `v0-opus-4.7-fast` enum value to the `modelConfiguration/modelId` response property for the response status `200`
- **2026-04-30** `670c302548ec` — 1 warning, 2 info
  - added the new `v0-opus-4.7` enum value to the `modelConfiguration/modelId` response property for the response status `200`
  - added the optional property `vercelProjectId` to the response with the `200` status
  - response property `modelConfiguration/modelId` reactivated
- **2026-03-06** `79811cd54faa` — 2 warning, 1 info
  - added the new `design-mode` enum value to the `messages/items/type` response property for the response status `200`
  - added the new `v0-auto` enum value to the `modelConfiguration/modelId` response property for the response status `200`
  - added the required property `metadata` to the response with the `200` status
- …earlier changes not shown

[Full history](https://skmtc.dev/vercel/apis/v0-platform-api-beta/changes/chats/:chatId/get.md)

---

[API](https://skmtc.dev/vercel/apis/v0-platform-api-beta.md) · [All operations](https://skmtc.dev/vercel/apis/v0-platform-api-beta/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/vercel/v0-platform-api-beta/revisions/3cf5debd6cf4/schema)