Skip to main content
Chats are conversation threads. You can attach Intelligence runs, Growth runs, and BD jobs to a chat by passing a chat_id. This keeps related tool calls and results organized for browsing and download.

​
Create a chat

​
POST /api/v1/chats

Create a new chat conversation.

​
Request body

​
title
string
Optional title. Defaults to "New Conversation".

​
Response

​
id
string
UUID of the new chat.
​
user_id
string
UUID of the owning user.
​
title
string
Chat title.
​
messages
array
Message history. Empty on creation.
​
created_at
string
ISO 8601 creation timestamp.
​
updated_at
string
ISO 8601 last-updated timestamp.
cURL
curl -X POST https://api.deepcurrent.app/api/v1/chats \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "title": "DeFi VC Outreach" }'
Response
{
  "id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
  "user_id": "550e8400-e29b-41d4-a716-446655440000",
  "title": "DeFi VC Outreach",
  "messages": [],
  "created_at": "2026-04-08T12:00:00Z",
  "updated_at": "2026-04-08T12:00:00Z"
}

​
List chats

​
GET /api/v1/chats

Return a paginated list of your chat conversations (excluding deleted ones).

​
Query parameters

​
limit
integer
Number of chats to return. Default 50, maximum 100.
​
offset
integer
Pagination offset. Default 0.
​
order_by
string
Sort field: updated_at (default) or created_at.
​
order
string
Sort direction: desc (default) or asc.

​
Response

​
chats
array
List of lightweight chat items.
​
total
integer
Total number of non-deleted chats.
​
limit
integer
Limit applied.
​
offset
integer
Offset applied.
cURL
curl "https://api.deepcurrent.app/api/v1/chats?limit=10&order=desc" \
  -H "Authorization: Bearer $TOKEN"

​
Get a chat

​
GET /api/v1/chats/{chat_id}

Return a single chat with its full message array.
​
chat_id
string
required
UUID of the chat.
Returns the full ChatPublic object including messages.
cURL
curl https://api.deepcurrent.app/api/v1/chats/d290f1ee-6c54-4b01-90e6-d701748f0851 \
  -H "Authorization: Bearer $TOKEN"

​
Update a chat

​
PUT /api/v1/chats/{chat_id}

Update the chat title or replace the messages array.
​
chat_id
string
required
UUID of the chat.

​
Request body

​
title
string
New title. Maximum 255 characters.
​
messages
array
Replacement messages array.
Returns the updated ChatPublic object.
cURL
curl -X PUT https://api.deepcurrent.app/api/v1/chats/d290f1ee-6c54-4b01-90e6-d701748f0851 \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "title": "DeFi VC Outreach — Q2 2026" }'

​
Delete a chat

​
DELETE /api/v1/chats/{chat_id}

Soft-delete a chat. The chat is hidden from list views but the data is retained. Returns 204 No Content.
​
chat_id
string
required
UUID of the chat to delete.
cURL
curl -X DELETE https://api.deepcurrent.app/api/v1/chats/d290f1ee-6c54-4b01-90e6-d701748f0851 \
  -H "Authorization: Bearer $TOKEN"