---
title: "List Chats"
method: GET
path: "/chats"
tags: ["Chats"]
---

# List Chats

`GET /chats`

Lists chats accessible to the authenticated user. Use metadata[key]=value style query parameters to filter by metadata.

## Query parameters

- `limit` integer
- `cursor` string
- `authorId` string
- `vercelProjectId` string
- `metadata` object

## Response `200`

Response for status 200

- object
  - `chats` object[], required — The chats in this page.
    - `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.
  - `cursor` string, nullable, required — Cursor to fetch the next page, or null if there are no more chats.

## Other responses

- `401` — Response for status 401
- `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/revisions/7c7a496f8022/schema)