Create Session

curl -X POST https://api.doctly.ai/api/v1/chat/sessions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"collection_ids": ["8f14e45f-ceea-467f-a34e-cbb17b0dbe1b"]}'

curl -X POST https://api.doctly.ai/api/v1/chat/sessions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"collection_ids": ["8f14e45f-ceea-467f-a34e-cbb17b0dbe1b"]}'

POST /api/v1/chat/sessions Creates a chat session bound to one or more collections. Sessions preserve conversation history: each message is answered with the prior turns as context. Sessions created with an API key belong to your account and are visible to all keys in the account.

Request

string[]

required

Collections used for retrieval in this session.

string

Optional session title. When omitted, a title is generated from the first exchange.

Response

string

Server-generated session ID. Use it for all subsequent calls.

string

Session title.

string[]

The session’s collections.

Response

{
  "id": "b31c9a52-4a86-4dd7-9f2e-1c2d3e4f5a6b",
  "title": "New Chat",
  "collection_ids": ["8f14e45f-ceea-467f-a34e-cbb17b0dbe1b"],
  "created_at": "2026-07-30T02:10:00Z",
  "updated_at": "2026-07-30T02:10:00Z"
}

Query Send Message

API Overview

Documents

Extractors

Collections

Collection Files

Chat

Create Session

Request

Response

​Request

​Response

Request

Response