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

# Update Chat

`PATCH /chats/{chatId}`

Updates a chat's title, privacy, or metadata.

## Path parameters

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

## Request body

- object
  - `title` string — A new title to assign to the chat.
  - `privacy` 'public' | 'private' | 'team' | 'team-edit' | 'unlisted' — Updated visibility setting for the chat.
  - `metadata` object, nullable — User-defined key-value metadata. Merged with existing entries. Pass `null` for a value to delete that key, or pass `null` for the whole field to delete all entries. Maximum 50 active entries.

## 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

---

[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)