Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.trellis.sh/llms.txt

Use this file to discover all available pages before exploring further.

Create an empty chat and return its id. Every other chat surface — Send Message, WebSocket, and Upload Files — now requires an existing chat_id. Call this endpoint first.
This replaces the previous behavior where omitting chat_id from POST /v1/chats or POST /v1/chats/uploads would lazily create one. Those surfaces now reject the request with a 400 MISSING_CHAT_ID error.
​
Authorization
string
required
Bearer token obtained from the authenticate endpoint.
​
title
string
Custom title for the chat. If omitted, a timestamp-based title is generated.
​
integration_id
string
ID of the database integration this chat will query. When supplied, it is validated against the caller’s organization and stored on the chat’s metadata so subsequent messages don’t need to resend it.

​
Response

​
id
string
required
The newly created chat’s ID. Pass this as chat_id on subsequent calls.
​
organization_id
string
required
Organization the chat belongs to.
​
member_id
string
required
Member the chat belongs to.
​
title
string
required
The chat’s title.
​
created_at
string
required
ISO 8601 timestamp when the chat was created.

​
Rate limits and caps

LimitValueResponse on breach
Creation rate20 requests per minute per JWT429 with Retry-After header
Open chats per member500409 OPEN_CHAT_CAP
The open-chat cap counts every chat that hasn’t been deleted; reach it and you must delete a chat (see Delete Chat or Delete Chats) before creating another. 
curl -X POST https://api.trellis.sh/v1/chats/create \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Q4 revenue review",
    "integration_id": "550e8400-e29b-41d4-a716-446655440000"
  }'

{
  "id": "chat_abc123",
  "organization_id": "org_abc123",
  "member_id": "550e8400-e29b-41d4-a716-446655440000",
  "title": "Q4 revenue review",
  "created_at": "2026-04-29T18:00:00+00:00"
}