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

Comet Traces API

Trace related resources

Comet Traces API is one of 42 APIs that Comet 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 authentication docs.

This API exposes 35 operations across 31 paths, and defines 46 schemas. It is described by OpenAPI 3.2.0, at version 1.0.0.

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

35 operations 31 paths 46 schemas 1 DELETE10 GET6 PATCH13 POST5 PUT

Metadata

The identity and technical contract details declared by the specification.

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

Paths & Operations 35

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

Traces 35

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 13 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 12 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
GET
/v1/private/traces/exists
Check whether a project has traces
tracesExist 4 params → 200
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 46

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

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

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

comet-traces-api-openapi.yml Raw ↑

Other APIs Comet publishes across the network.

Comet Agent Configs API
Comet Agent Insights API
Comet Agent Insights Jobs API
Comet Alerts API
Comet Annotation Queues API
Comet Assertion Results API
Comet Attachments API
Comet Automation rule evaluators API
Comet Chat Completions API
Comet Check API
Comet Dashboards API
Comet Datasets API
Where this information came from

This is an independent, third-party profile of Comet 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.