Public Links
Shareable URLs that let unauthenticated users chat with agents. Supports optional email verification, session persistence, per-user memory, and rate limiting.
Concepts
/public/chat/{token}) that allows anyone to chat with an agent without logging in.(agent_name, user_email). Updated via background summarization every 5 messages.How It Works
Open the agent detail page and go to the Sharing tab.
Click Create Public Link.
Configure the link: email verification on/off, rate limits, custom welcome message.
Copy the generated URL and share it with recipients.
Recipients open the URL and start chatting immediately.
If email verification is enabled: the user enters their email, receives a verification code, verifies, then chats.
Conversations persist — the user can return later and continue where they left off.
Click New Conversation to start a fresh session.
Chat History for Logged-In Users
When a Trinity user who is logged in opens a public chat link, a history dropdown appears at the top of the chat interface showing their previous conversations with that agent. This lets them resume any past session rather than always starting fresh.
API Endpoints
| Endpoint | Method | Description |
|---|---|---|
| /api/agents/{name}/public-links | GET | List public links |
| /api/agents/{name}/public-links | POST | Create a public link |
| /api/agents/{name}/public-links/{id} | PUT | Update a public link |
| /api/agents/{name}/public-links/{id} | DELETE | Delete a public link |
| /api/public/chat/{token} | POST | Send a message via public chat |
| /api/public/history/{token} | GET | Retrieve chat history |