List chat sessions matching the supplied filters.
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://blackbox.dasha.ai/api/v1/chats', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));curl --request GET \
--url https://blackbox.dasha.ai/api/v1/chats \
--header 'Authorization: Bearer <token>'import requests
url = "https://blackbox.dasha.ai/api/v1/chats"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"items": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"agent_id": "<string>",
"channel": "<string>",
"messages": [
{
"role": "<string>",
"content": "<string>",
"tool_calls": [
{
"id": "<string>",
"name": "<string>",
"arguments": "<unknown>",
"response": "<unknown>"
}
],
"time": "2023-11-07T05:31:56Z"
}
],
"created_time": "2023-11-07T05:31:56Z",
"last_activity": "2023-11-07T05:31:56Z",
"ttl_seconds": 123,
"is_final": true,
"status": "<string>",
"final_reason": "<string>"
}
],
"total_count": 123,
"skip": 123,
"take": 123
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>"
}List chat sessions matching the supplied filters.
Ordered by last_activity descending. Default filter is state=active —
pass state=final or state=all to broaden. updated_after is useful
for incremental sync.
GET
/
api
/
v1
/
chats
List chat sessions matching the supplied filters.
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://blackbox.dasha.ai/api/v1/chats', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));curl --request GET \
--url https://blackbox.dasha.ai/api/v1/chats \
--header 'Authorization: Bearer <token>'import requests
url = "https://blackbox.dasha.ai/api/v1/chats"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"items": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"agent_id": "<string>",
"channel": "<string>",
"messages": [
{
"role": "<string>",
"content": "<string>",
"tool_calls": [
{
"id": "<string>",
"name": "<string>",
"arguments": "<unknown>",
"response": "<unknown>"
}
],
"time": "2023-11-07T05:31:56Z"
}
],
"created_time": "2023-11-07T05:31:56Z",
"last_activity": "2023-11-07T05:31:56Z",
"ttl_seconds": 123,
"is_final": true,
"status": "<string>",
"final_reason": "<string>"
}
],
"total_count": 123,
"skip": 123,
"take": 123
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>"
}Query Parameters
Filter to sessions driven by this agent id.
Filter to sessions on this channel.
Lifecycle filter: active (default), final, or all.
Filter to sessions with last_activity after this timestamp.
Pagination offset (default 0).
Page size (default 20, max 200).
Response
Returns paginated list of sessions.
Paginated result of GET /api/v1/chats.
Was this page helpful?