Retrieve a paginated list of threads with filtering options for assistant, organization, and visibility. Uses cursor-based pagination for efficient navigation through large result sets.
limit integer optional · Defaults to 20
Number of threads to return. Must be between 1 and 100.
order string optional · Defaults to desc
Sort order for threads. Available values: asc (oldest first), desc (newest first).
after string optional
Cursor for pagination. Returns threads created after the specified thread ID.
before string optional
Cursor for pagination. Returns threads created before the specified thread ID.
assistantId string optional
Filter threads by assistant ID. Only returns threads bound to the specified assistant.
visibleInUi boolean optional
Filter threads by UI visibility. true returns only visible threads, false returns only hidden threads.
- Bash
- Python
- JavaScript
curl "https://api.freddy.aitronos.com/v1/threads?limit=20" \
-H "Authorization: Bearer $FREDDY_API_KEY"{
"object": "list",
"data": [
{
"id": "thread_abc123",
"object": "thread",
"createdAt": 1741476542,
"updatedAt": 1741476600,
"metadata": {
"category": "support",
"priority": "high"
},
"assistantId": "asst_support_agent",
"organizationId": "ORG_123",
"userId": "uid_user123",
"title": "Customer Support Query",
"visibleInUi": true,
"messageCount": 5,
"status": "streaming"
},
{
"id": "thread_xyz789",
"object": "thread",
"createdAt": 1741476000,
"updatedAt": 1741476100,
"metadata": {},
"assistantId": null,
"organizationId": "ORG_123",
"userId": "uid_user123",
"title": "General Question",
"visibleInUi": true,
"messageCount": 2,
"status": "inactive"
}
],
"firstId": "thread_abc123",
"lastId": "thread_xyz789",
"hasMore": true
}