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
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Need help?

Contact us
Comet

Comet Spans API

Span related resources

Documentation Provider Profile APIs.io OpenAPI GitHub

Comet Spans API is one of 42 APIs that Comet publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Spans. The published artifact set on APIs.io includes an OpenAPI specification and authentication docs.

This API exposes 18 operations across 14 paths, and defines 31 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.

18 operations 14 paths 31 schemas 1 DELETE6 GET3 PATCH6 POST2 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
Contact
Github Repository
License
Apache 2.0
Resource Areas
1

Paths & Operations 18

Across 14 paths, the API surfaces 18 operations — 1 DELETE, 6 GET, 3 PATCH, 6 POST, 2 PUT. Each is listed below with its method, path, parameters, and response codes.

Spans 18

Span related resources

POST
/v1/private/spans/{id}/comments
Add span comment
addSpanComment 1 param body → 201
PUT
/v1/private/spans/{id}/feedback-scores
Add span feedback score
addSpanFeedbackScore 1 param body → 204
POST
/v1/private/spans/batch
Create spans
createSpans body → 204
PATCH
/v1/private/spans/batch
Batch update spans
batchUpdateSpans body → 204400
GET
/v1/private/spans
Get spans by projectname or projectid and optionally by traceid and/or type
getSpansByProject 14 params → 200
POST
/v1/private/spans
Create span
createSpan body → 201409
GET
/v1/private/spans/{id}
Get span by id
getSpanById 2 params → 200404
DELETE
/v1/private/spans/{id}
Delete span by id
deleteSpanById 1 param → 501204
PATCH
/v1/private/spans/{id}
Update span by id
updateSpan 1 param body → 204404
POST
/v1/private/spans/comments/delete
Delete span comments
deleteSpanComments body → 204
POST
/v1/private/spans/{id}/feedback-scores/delete
Delete span feedback score
deleteSpanFeedbackScore 1 param body → 204
GET
/v1/private/spans/feedback-scores/names
Find Feedback Score names
findFeedbackScoreNames_1 2 params → 200
GET
/v1/private/spans/{spanId}/comments/{commentId}
Get span comment
getSpanComment 2 params → 200404
GET
/v1/private/spans/stats
Get span stats
getSpanStats 8 params → 200
PUT
/v1/private/spans/feedback-scores
Batch feedback scoring for spans
scoreBatchOfSpans body → 204
POST
/v1/private/spans/search
Search spans
searchSpans body → 200400
GET
/v1/private/spans/exists
Check whether a project has spans
spansExist 3 params → 200
PATCH
/v1/private/spans/comments/{commentId}
Update span comment by id
updateSpanComment 1 param body → 204404

Schemas 31

The contract defines 31 schemas that model the data the API accepts and returns. The most detailed are Span_Public (29 properties), Span_Write (22 properties), SpanUpdate (21 properties), FeedbackScore_Public (11 properties). Each schema is shown below with its type and property counts.

ErrorMessage_Public
object
3 properties
JsonListString_Write
object
SpanBatch_Write
object
1 property 1 required
ValueEntry
object
9 properties
ScoreName_Public
object
2 properties
Span_Write
object
22 properties 1 required
ErrorMessage
object
3 properties
ExistenceResponse
object
1 property
ProjectStats_Public
object
1 property
ErrorInfo
object
3 properties 2 required
Span_Public
object
29 properties 1 required
SpanSearchStreamRequest_Public
object
11 properties
JsonListString_Public
object
ErrorInfo_Write
object
3 properties 2 required
SpanBatchUpdate
object
Request to batch update multiple spans
3 properties 2 required
Comment
object
7 properties 1 required
JsonListString
object
SpanFilter_Public
object
4 properties
FeedbackScore
object
11 properties 3 required
Comment_Public
object
7 properties 1 required
SpanUpdate
object
21 properties 1 required
DeleteFeedbackScore
object
3 properties 1 required
BatchDelete
object
1 property 1 required
ErrorInfo_Public
object
3 properties 2 required
FeedbackScoreNames_Public
object
1 property
FeedbackScore_Public
object
Aggregated feedback scores from all spans in this trace, averaged by score name
11 properties 3 required
SpanPage_Public
object
5 properties
FeedbackScoreBatch
object
1 property 1 required
FeedbackScoreBatchItem
object
10 properties 4 required
ValueEntry_Public
object
9 properties
ProjectStatItemObject_Public
object
2 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

comet-spans-api-openapi.yml Raw ↑

Other APIs Comet publishes across the network.

Comet Agent Configs API
AE Profile APIs.io
Comet Agent Insights API
AE Profile APIs.io
Comet Agent Insights Jobs API
AE Profile APIs.io
Comet Alerts API
AE Profile APIs.io
Comet Annotation Queues API
AE Profile APIs.io
Comet Assertion Results API
AE Profile APIs.io
Comet Attachments API
AE Profile APIs.io
Comet Automation rule evaluators API
AE Profile APIs.io
Comet Chat Completions API
AE Profile APIs.io
Comet Check API
AE Profile APIs.io
Comet Dashboards API
AE Profile APIs.io
Comet Datasets API
AE Profile APIs.io
#Spans
← Back to C APIs
API Details
ID
comet:comet-spans-api
Base URL
https://www.comet.com/opik/api/v1
Docs
https://www.comet.com/docs/opik/reference/rest-api/overview
Provider
Comet
APIs.io →  GitHub →
Explore more
All APIs Providers APIs.io Network
Work with this as data

Every API here is available over the API and to AI agents over MCP. APIs is not yet its own endpoint on the v1 API. Reach this content through network search and the tag graph, or the MCP server below.

Installs https://mcp.apievangelist.com/mcp in Claude, Cursor, VS Code and the rest — one button, every client.

MCP tools for apis
4 tools reach this content
  • search_api_evangelistSearch every content type across the network at once.
  • find_relatedThe shared-tag relevance graph — what else covers this.
  • get_tagEverything one tag labels, across all content types.
  • guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.
All tools & prompts
Call it yourself
curl for this page
Search the network for this 
curl "https://api.apievangelist.com/v1/search?q=comet-spans-api&limit=10"
Everything under a tag 
curl "https://api.apievangelist.com/v1/tags/comet-spans-api"

Discovery needs no key. Full bodies and the synthesis endpoints are Pro.

Get an API key

Free tier, no email required. Sign in with whichever identity you already have.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have. Your account

Where this information came from

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