Chats

Create, list, read, and delete conversations.

Chats belong to the user behind the API key. Another user’s id is 404 CHAT_NOT_FOUND.

Create

POST /api/v1/chats returns 201. This is optional. To send a first message in one call, use POST /api/v1/completions and omit chatId.

title · string

Optional. 1–120 characters. Omitted titles get a default.

{ "title": "Launch plan" }

{
  "id": "11111111-1111-4111-8111-111111111111",
  "title": "Launch plan",
  "isFavorite": false,
  "lastMessageAt": "2026-09-22T07:00:00.000Z",
  "lastMessageId": null,
  "createdAt": "2026-09-22T07:00:00.000Z",
  "updatedAt": "2026-09-22T07:00:00.000Z"
}

List

GET /api/v1/chats

limit · integer · default: "20"

Page size, 1–50.

cursor · string

Pass nextCursor from the previous page.

q · string

Title search.

favorite · string

true or false.

{
  "items": [],
  "nextCursor": null
}

Newest first. GET /api/v1/chats/{chatId} returns one chat object.

Delete

DELETE /api/v1/chats/{chatId} returns 204. The row is soft-deleted. A repeat delete of someone else’s chat is 404.