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

# Get Preview URL

`GET /chats/{chatId}/preview`

Returns the preview URL for a chat. If the preview isn't ready, the response is null. Poll this endpoint until the response is non-null.

## Path parameters

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

## Response `200`

The preview details, or null if the preview is still starting. Poll this endpoint until the response is non-null.

- object, nullable — The preview details, or null if the preview is still starting. Poll this endpoint until the response is non-null.
  - `url` string, uri, required — The preview URL for this chat.
  - `token` string, required — A short-lived token for accessing the preview URL via the x-v0-preview-token header.
  - `expiresAt` string, date-time, required — The ISO timestamp when token expires.

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