Chats
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
422
Validation Error
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 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
422
Validation Error
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 a chat by ID
Path parameters
project_idstringRequired
chat_idstringRequired
Responses
200
Successful Response
application/json
422
Validation Error
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 a chat
Path parameters
project_idstringRequired
chat_idstringRequired
Responses
200
Successful Response
application/json
422
Validation Error
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 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
422
Validation Error
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"
}