Chats

List Chats

get

List all chats for a project with optional filtering Parameters: - project_id: The ID of the project to list chats for - owner: Optional owner to filter chats by

Path parameters
project_idstringRequired
Query parameters
ownerstringOptional
Responses
200
Successful Response
application/json
get
GET /v1/projects/{project_id}/chats HTTP/1.1
Host: api.chicory.ai
Accept: */*

{
  "chats": [
    {
      "id": "text",
      "project_id": "text",
      "name": "text",
      "description": "text",
      "owner": "text",
      "message_count": 1,
      "created_at": "2025-07-18T19:49:55.257Z",
      "updated_at": "2025-07-18T19:49:55.257Z"
    }
  ]
}

Create Chat

post

Create a new chat for a project

Path parameters
project_idstringRequired
Body

Schema for creating a chat

namestring · min: 1 · max: 100Required
descriptionstring · max: 500Optional
ownerstringOptional

Owner or creator of the chat

Responses
201
Successful Response
application/json
post
POST /v1/projects/{project_id}/chats HTTP/1.1
Host: api.chicory.ai
Content-Type: application/json
Accept: */*
Content-Length: 51

{
  "name": "text",
  "description": "text",
  "owner": "text"
}
{
  "id": "text",
  "project_id": "text",
  "name": "text",
  "description": "text",
  "owner": "text",
  "message_count": 1,
  "created_at": "2025-07-18T19:49:55.257Z",
  "updated_at": "2025-07-18T19:49:55.257Z"
}

Get Chat

get

Get a chat by ID

Path parameters
project_idstringRequired
chat_idstringRequired
Responses
200
Successful Response
application/json
get
GET /v1/projects/{project_id}/chats/{chat_id} HTTP/1.1
Host: api.chicory.ai
Accept: */*

{
  "id": "text",
  "project_id": "text",
  "name": "text",
  "description": "text",
  "owner": "text",
  "message_count": 1,
  "created_at": "2025-07-18T19:49:55.257Z",
  "updated_at": "2025-07-18T19:49:55.257Z"
}

Delete Chat

delete

Delete a chat

Path parameters
project_idstringRequired
chat_idstringRequired
Responses
200
Successful Response
application/json
delete
DELETE /v1/projects/{project_id}/chats/{chat_id} HTTP/1.1
Host: api.chicory.ai
Accept: */*

{
  "ANY_ADDITIONAL_PROPERTY": "text"
}

Update Chat

patch

Update chat information

Path parameters
project_idstringRequired
chat_idstringRequired
Body

Schema for updating a chat

namestring · min: 1 · max: 100Optional
descriptionstring · max: 500Optional
Responses
200
Successful Response
application/json
patch
PATCH /v1/projects/{project_id}/chats/{chat_id} HTTP/1.1
Host: api.chicory.ai
Content-Type: application/json
Accept: */*
Content-Length: 36

{
  "name": "text",
  "description": "text"
}
{
  "id": "text",
  "project_id": "text",
  "name": "text",
  "description": "text",
  "owner": "text",
  "message_count": 1,
  "created_at": "2025-07-18T19:49:55.257Z",
  "updated_at": "2025-07-18T19:49:55.257Z"
}
PreviousMessagesNextHealth