How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Opik Traces API

Trace related resources

Opik Traces API is one of 39 APIs that Opik publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Traces. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 34 operations across 30 paths, and defines 45 schemas. It is described by OpenAPI 3.1.0, at version 1.0.0.

Requests are made against 2 base URLs: http://localhost:5173/api, https://www.comet.com/opik/api.

34 operations 30 paths 45 schemas 1 DELETE9 GET6 PATCH13 POST5 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
1.0.0
Base URL
https://www.comet.com/opik/api/v1
License
Resource Areas
1

Paths & Operations 34

Across 30 paths, the API surfaces 34 operations — 1 DELETE, 9 GET, 6 PATCH, 13 POST, 5 PUT. Each is listed below with its method, path, parameters, and response codes.

Traces 34

Trace related resources

POST
/v1/private/traces/threads/{id}/comments
Add thread comment
addThreadComment 1 param body → 201
POST
/v1/private/traces/{id}/comments
Add trace comment
addTraceComment 1 param body → 201
PUT
/v1/private/traces/{id}/feedback-scores
Add trace feedback score
addTraceFeedbackScore 1 param body → 204
POST
/v1/private/traces/batch
Create traces
createTraces body → 204
PATCH
/v1/private/traces/batch
Batch update traces
batchUpdateTraces body → 204400
PATCH
/v1/private/traces/threads/batch
Batch update threads
batchUpdateThreads body → 204400
PUT
/v1/private/traces/threads/close
Close trace thread(s)
closeTraceThread body → 204404
GET
/v1/private/traces
Get traces by projectname or projectid
getTracesByProject 12 params → 200
POST
/v1/private/traces
Create trace
createTrace body → 201
GET
/v1/private/traces/{id}
Get trace by id
getTraceById 2 params → 200
DELETE
/v1/private/traces/{id}
Delete trace by id
deleteTraceById 1 param → 204
PATCH
/v1/private/traces/{id}
Update trace by id
updateTrace 1 param body → 204
POST
/v1/private/traces/threads/comments/delete
Delete thread comments
deleteThreadComments body → 204
POST
/v1/private/traces/threads/feedback-scores/delete
Delete thread feedback scores
deleteThreadFeedbackScores body → 204
POST
/v1/private/traces/comments/delete
Delete trace comments
deleteTraceComments body → 204
POST
/v1/private/traces/{id}/feedback-scores/delete
Delete trace feedback score
deleteTraceFeedbackScore 1 param body → 204
POST
/v1/private/traces/threads/delete
Delete trace threads
deleteTraceThreads body → 204
POST
/v1/private/traces/delete
Delete traces
deleteTraces body → 204
GET
/v1/private/traces/feedback-scores/names
Find Feedback Score names
findFeedbackScoreNames_2 1 param → 200
GET
/v1/private/traces/threads/feedback-scores/names
Find Trace Threads Feedback Score names
findTraceThreadsFeedbackScoreNames 1 param → 200
GET
/v1/private/traces/stats
Get trace stats
getTraceStats 6 params → 200
GET
/v1/private/traces/threads/{threadId}/comments/{commentId}
Get thread comment
getThreadComment 2 params → 200404
GET
/v1/private/traces/threads/stats
Get trace thread stats
getTraceThreadStats 6 params → 200
GET
/v1/private/traces/{traceId}/comments/{commentId}
Get trace comment
getTraceComment 2 params → 200404
POST
/v1/private/traces/threads/retrieve
Get trace thread
getTraceThread body → 200404
GET
/v1/private/traces/threads
Get trace threads
getTraceThreads 11 params → 200
PUT
/v1/private/traces/threads/open
Open trace thread
openTraceThread body → 204
PUT
/v1/private/traces/threads/feedback-scores
Batch feedback scoring for threads
scoreBatchOfThreads body → 204
PUT
/v1/private/traces/feedback-scores
Batch feedback scoring for traces
scoreBatchOfTraces body → 204
POST
/v1/private/traces/threads/search
Search trace threads
searchTraceThreads body → 200400
POST
/v1/private/traces/search
Search traces
searchTraces body → 200400401
PATCH
/v1/private/traces/threads/{threadModelId}
Update thread
updateThread 1 param body → 204404
PATCH
/v1/private/traces/threads/comments/{commentId}
Update thread comment by id
updateThreadComment 1 param body → 204404
PATCH
/v1/private/traces/comments/{commentId}
Update trace comment by id
updateTraceComment 1 param body → 204404

Schemas 45

The contract defines 45 schemas that model the data the API accepts and returns. The most detailed are Trace_Public (31 properties), TraceThread (20 properties), TraceUpdate (15 properties), Trace_Write (15 properties). Each schema is shown below with its type and property counts.

ErrorMessage_Public
object
3 properties
FeedbackScoreBatchItemThread
object
9 properties 4 required
Comment_Public
object
6 properties 1 required
ValueEntry
object
7 properties
ErrorInfo_Write
object
3 properties 2 required
FeedbackScore_Public
object
Aggregated feedback scores from all spans in this trace, averaged by score name
10 properties 3 required
TraceBatchUpdate
object
Request to batch update multiple traces
3 properties 2 required
TraceBatch_Write
object
1 property 1 required
ErrorMessage
object
3 properties
ProjectStats_Public
object
1 property
FeedbackScoreBatchItem
object
9 properties 4 required
ErrorInfo_Public
object
3 properties 2 required
Trace_Public
object
31 properties 1 required
GuardrailsValidation_Public
object
2 properties
TraceUpdate
object
15 properties
JsonListString
object
JsonListString_Public
object
TraceThread
object
20 properties
TraceSearchStreamRequest_Public
object
10 properties
TraceFilter_Public
object
4 properties
DeleteTraceThreads
object
3 properties 1 required
JsonListString_Write
object
TraceThreadPage
object
5 properties
Trace_Write
object
15 properties 1 required
ExperimentItemReference_Public
object
Experiment reference with ID, name, dataset ID, and dataset item ID
4 properties 4 required
TracePage_Public
object
5 properties
DeleteFeedbackScore
object
2 properties 1 required
DeleteThreadFeedbackScores
object
4 properties 3 required
TraceThreadIdentifier
object
4 properties 1 required
FeedbackScoreNames_Public
object
1 property
Comment
object
6 properties 1 required
ErrorInfo
object
3 properties 2 required
ValueEntry_Public
object
7 properties
FeedbackScoreBatchThread
object
1 property 1 required
TraceThreadBatchIdentifier
object
4 properties
BatchDelete
object
1 property 1 required
ScoreName_Public
object
2 properties
ProjectStatItemObject_Public
object
2 properties
TraceThreadUpdate
object
3 properties
FeedbackScore
object
10 properties 3 required
Check_Public
object
2 properties
TraceThreadFilter
object
4 properties
FeedbackScoreBatch
object
1 property 1 required
TraceThreadSearchStreamRequest
object
9 properties
TraceThreadBatchUpdate
object
Request to batch update multiple trace threads
3 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

opik-traces-api-openapi.yml Raw ↑

Other APIs Opik publishes across the network.

Opik Agent Configs API
Opik AI Spend API
Opik Alerts API
Opik Annotation Queues API
Opik Assertion Results API
Opik Attachments API
Opik Automation rule evaluators API
Opik Chat Completions API
Opik Check API
Opik Dashboards API
Opik Datasets API
Opik Environments API
Where this information came from

This is an independent, third-party profile of Opik Traces API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.