For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Copy to LLMGithubGo to App
DocumentationIntegrationsBuilding Self-Improving AgentsSelf-hosting OpikSDK & API reference
DocumentationIntegrationsBuilding Self-Improving AgentsSelf-hosting OpikSDK & API reference
    • Overview
  • Python SDK
    • Reference
    • REST API Client
  • Typescript SDK
    • Overview
    • Opik TS
    • Prompts
    • Opik Query Language (OQL)
  • Rest API
    • Overview
        • POSTAdd thread comment
        • POSTAdd trace comment
        • PUTAdd trace feedback score
        • POSTCreate traces
        • PATCHBatch update traces
        • PATCHBatch update threads
        • PUTClose trace thread(s)
        • GETGet traces by project_name or project_id
        • POSTCreate trace
        • GETGet trace by id
        • DELDelete trace by id
        • PATCHUpdate trace by id
        • POSTDelete thread comments
        • POSTDelete thread feedback scores
        • POSTDelete trace comments
        • POSTDelete trace feedback score
        • POSTDelete trace threads
        • POSTDelete traces
        • GETFind Feedback Score names
        • GETFind Trace Threads Feedback Score names
        • GETGet trace stats
        • GETGet thread comment
        • GETGet trace thread stats
        • GETGet trace comment
        • POSTGet trace thread
        • GETGet trace threads
        • PUTOpen trace thread
        • PUTBatch feedback scoring for threads
        • PUTBatch feedback scoring for traces
        • POSTSearch trace threads
        • POSTSearch traces
        • PATCHUpdate thread
        • PATCHUpdate thread comment by id
        • PATCHUpdate trace comment by id
LogoLogo
Copy to LLMGithubGo to App
Rest APIAPI ReferenceTraces

Get trace threads

GET
/v1/private/traces/threads
GET
/api/v1/private/traces/threads
$curl http://localhost:5173/api/v1/private/traces/threads
200Retrieved
1{
2  "page": 1,
3  "size": 1,
4  "total": 1,
5  "content": [
6    {
7      "id": "string",
8      "project_id": "string",
9      "thread_model_id": "string",
10      "start_time": "2024-01-15T09:30:00Z",
11      "end_time": "2024-01-15T09:30:00Z",
12      "duration": 1.1,
13      "first_message": {},
14      "last_message": {},
15      "feedback_scores": [
16        {
17          "name": "string",
18          "value": 1.1,
19          "source": "ui",
20          "category_name": "string",
21          "reason": "string",
22          "created_at": "2024-01-15T09:30:00Z",
23          "last_updated_at": "2024-01-15T09:30:00Z",
24          "created_by": "string",
25          "last_updated_by": "string",
26          "value_by_author": {}
27        }
28      ],
29      "status": "active",
30      "number_of_messages": 1,
31      "total_estimated_cost": 1.1,
32      "usage": {},
33      "comments": [
34        {
35          "text": "string",
36          "id": "string",
37          "created_at": "2024-01-15T09:30:00Z",
38          "last_updated_at": "2024-01-15T09:30:00Z",
39          "created_by": "string",
40          "last_updated_by": "string"
41        }
42      ],
43      "tags": [
44        "string"
45      ],
46      "last_updated_at": "2024-01-15T09:30:00Z",
47      "last_updated_by": "string",
48      "created_by": "string",
49      "created_at": "2024-01-15T09:30:00Z",
50      "environment": "string"
51    }
52  ],
53  "sortableBy": [
54    "string"
55  ]
56}
Get trace threads
Was this page helpful?
Previous

Open trace thread

Next
Built with

Query parameters

pageintegerOptional>=1Defaults to 1
sizeintegerOptional>=1Defaults to 10
project_namestringOptional
project_idstringOptionalformat: "uuid"
truncatebooleanOptionalDefaults to false
strip_attachmentsbooleanOptionalDefaults to false
filtersstringOptional
sortingstringOptional
searchstringOptional
from_timedatetimeOptional
to_timedatetimeOptional

Response

Trace threads resource
pageinteger
sizeinteger
totallong
contentlist of objects
sortableBylist of strings