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
Opik

Opik Spans API

Span related resources

Documentation Provider Profile APIs.io OpenAPI GitHub

Opik Spans API is one of 39 APIs that Opik 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 API documentation.

This API exposes 17 operations across 13 paths, and defines 30 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.

17 operations 13 paths 30 schemas 1 DELETE5 GET3 PATCH6 POST2 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
Contact
Github Repository
License
Apache 2.0
Resource Areas
1

Paths & Operations 17

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

Spans 17

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
PATCH
/v1/private/spans/comments/{commentId}
Update span comment by id
updateSpanComment 1 param body → 204404

Schemas 30

The contract defines 30 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), SpanSearchStreamRequest_Public (11 properties). Each schema is shown below with its type and property counts.

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

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

opik-spans-api-openapi.yml Raw ↑

Other APIs Opik publishes across the network.

Opik Agent Configs API
AE Profile APIs.io
Opik AI Spend API
AE Profile APIs.io
Opik Alerts API
AE Profile APIs.io
Opik Annotation Queues API
AE Profile APIs.io
Opik Assertion Results API
AE Profile APIs.io
Opik Attachments API
AE Profile APIs.io
Opik Automation rule evaluators API
AE Profile APIs.io
Opik Chat Completions API
AE Profile APIs.io
Opik Check API
AE Profile APIs.io
Opik Dashboards API
AE Profile APIs.io
Opik Datasets API
AE Profile APIs.io
Opik Environments API
AE Profile APIs.io
#Spans
← Back to O APIs
API Details
ID
opik:opik-spans-api
Base URL
https://www.comet.com/opik/api/v1
Docs
https://www.comet.com/docs/opik/reference/rest-api/overview
Provider
Opik
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=opik-spans-api&limit=10"
Everything under a tag 
curl "https://api.apievangelist.com/v1/tags/opik-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 Opik 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.