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

Search trace threads

POST
/v1/private/traces/threads/search
POST
/api/v1/private/traces/threads/search
$curl -X POST http://localhost:5173/api/v1/private/traces/threads/search \
> -H "Content-Type: application/json" \
> -d '{}'
200Successful
1{}
Search trace threads
Was this page helpful?
Previous

Search traces

Next
Built with

Request

This endpoint expects an object.
project_namestringOptional
project_idstringOptionalformat: "uuid"
filterslist of objectsOptional
last_retrieved_thread_model_idstringOptionalformat: "uuid"
limitintegerOptional1-2000Defaults to 500
Max number of trace thread to be streamed
truncatebooleanOptionalDefaults to true
Truncate input, output and metadata to slim payloads
strip_attachmentsbooleanOptionalDefaults to false

If true, returns attachment references like [file.png]; if false, downloads and reinjects stripped attachments

from_timedatetimeOptional

Filter trace threads created from this time (ISO-8601 format).

to_timedatetimeOptional

Filter trace threads created up to this time (ISO-8601 format). If not provided, defaults to current time. Must be after ‘from_time’.

Response

Trace threads stream or error during process