Chat Share API

Chat share routes let a signed-in user publish or revoke read-only views of a conversation, similar to ChatGPT’s shareable links. Authenticated routes live under /api/v1/share, while anonymous consumers access /api/v1/public/share.

Quick facts

Authenticated calls require an Auth0 Bearer token
Share IDs are short, URL-safe identifiers generated via nanoid
Public viewers are fingerprinted via IP + User-Agent to track viewCount and enforce continuation limits
Expiration defaults to “never” but can be overridden per share (1–365 days)

Capability	Endpoint(s)	Description
Create	`POST /share`	Mint a new share link for the given conversation
List	`GET /share/list`	Paginate through the caller’s active, expired, or revoked shares
Update	`PATCH /share/{shareId}`	Control continuation, expiration, and copy
Revoke	`DELETE /share/{shareId}`	Immediately disable a share
Analytics	`GET /share/{shareId}/analytics`	Inspect total views, unique viewers, and continuation counts
Public access	`GET /public/share/{shareId}`, `POST /public/share/{shareId}/continue`	Consume a shared transcript or fork it into a new conversation

Check each endpoint page for request/response schemas, example payloads, and the interactive OpenAPI console.

Overview

Auth service

AI service

Prompt management

Mobile app

Platform

Conversations

Chat Share

Files

User Profile

Visual Embeds

Second Opinion

Quick facts

​Quick facts

Quick facts