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 Datasets API

Dataset resources

Documentation Provider Profile APIs.io OpenAPI GitHub

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

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

This API exposes 36 operations across 32 paths, and defines 72 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.

36 operations 32 paths 72 schemas 2 DELETE12 GET3 PATCH16 POST3 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 36

Across 32 paths, the API surfaces 36 operations — 2 DELETE, 12 GET, 3 PATCH, 16 POST, 3 PUT. Each is listed below with its method, path, parameters, and response codes.

Datasets 36

Dataset resources

POST
/v1/private/datasets/{id}/items/changes
Apply changes to dataset items
applyDatasetItemChanges 2 params body → 201400404409
PATCH
/v1/private/datasets/items/batch
Batch update dataset items
batchUpdateDatasetItems body → 204400
GET
/v1/private/datasets
Find datasets
findDatasets 9 params → 200
POST
/v1/private/datasets
Create dataset
createDataset body → 201
PUT
/v1/private/datasets/items
Create/update dataset items
createOrUpdateDatasetItems body → 204
POST
/v1/private/datasets/items/from-csv
Create dataset items from CSV file
createDatasetItemsFromCsv body → 202400
POST
/v1/private/datasets/items/from-json
Create dataset items from JSON file
createDatasetItemsFromJson body → 202400
POST
/v1/private/datasets/{dataset_id}/items/from-spans
Create dataset items from spans
createDatasetItemsFromSpans 1 param body → 204
POST
/v1/private/datasets/{dataset_id}/items/from-traces
Create dataset items from traces
createDatasetItemsFromTraces 1 param body → 204
GET
/v1/private/datasets/{id}
Get dataset by id
getDatasetById 1 param → 200
PUT
/v1/private/datasets/{id}
Update dataset by id
updateDataset 1 param body → 204
DELETE
/v1/private/datasets/{id}
Delete dataset by id
deleteDataset 1 param → 204
POST
/v1/private/datasets/delete
Delete dataset by name
deleteDatasetByName body → 204
POST
/v1/private/datasets/items/delete
Delete dataset items
deleteDatasetItems body → 204400
POST
/v1/private/datasets/delete-batch
Delete datasets
deleteDatasetsBatch body → 204
GET
/v1/private/datasets/export-jobs/{jobId}/download
Download dataset export file
downloadDatasetExport 1 param → 200400404
POST
/v1/private/datasets/{id}/expansions
Expand dataset with synthetic samples
expandDataset 1 param body → 200
GET
/v1/private/datasets/{id}/items/experiments/items
Find dataset items with experiment items
findDatasetItemsWithExperimentItems 8 params → 200
POST
/v1/private/datasets/retrieve
Get dataset by name
getDatasetByIdentifier body → 200
GET
/v1/private/datasets/{id}/items/experiments/items/stats
Get experiment items stats for dataset
getDatasetExperimentItemsStats 3 params → 200
GET
/v1/private/datasets/export-jobs/{jobId}
Get dataset export job status
getDatasetExportJob 1 param → 200404
GET
/v1/private/datasets/export-jobs
Get all dataset export jobs
getDatasetExportJobs → 200
GET
/v1/private/datasets/items/{itemId}
Get dataset item by id
getDatasetItemById 1 param → 200
PATCH
/v1/private/datasets/items/{itemId}
Partially update dataset item by id
patchDatasetItem 1 param body → 204404
GET
/v1/private/datasets/{id}/items
Get dataset items
getDatasetItems 6 params → 200
GET
/v1/private/datasets/{id}/items/experiments/items/output/columns
Get dataset items output columns
getDatasetItemsOutputColumns 2 params → 200
PUT
/v1/private/datasets/export-jobs/{jobId}/mark-viewed
Mark dataset export job as viewed
markDatasetExportJobViewed 1 param → 204404
POST
/v1/private/datasets/{id}/export
Start dataset CSV export
startDatasetExport 1 param → 202200
POST
/v1/private/datasets/items/stream
Stream dataset items
streamDatasetItems body → 200
GET
/v1/private/datasets/{id}/versions/diff
Compare latest version with draft
compareDatasetVersions 1 param → 200404
POST
/v1/private/datasets/{id}/versions/hash/{versionHash}/tags
Create version tag
createVersionTag 2 params body → 204400404409
DELETE
/v1/private/datasets/{id}/versions/{versionHash}/tags/{tag}
Delete version tag
deleteVersionTag 3 params → 204
GET
/v1/private/datasets/{id}/versions
List dataset versions
listDatasetVersions 3 params → 200400
POST
/v1/private/datasets/{id}/versions/restore
Restore dataset to a previous version
restoreDatasetVersion 1 param body → 200404
POST
/v1/private/datasets/{id}/versions/retrieve
Retrieve dataset version by name
retrieveDatasetVersion 1 param body → 200400404
PATCH
/v1/private/datasets/{id}/versions/hash/{versionHash}
Update dataset version
updateDatasetVersion 2 params body → 200400404409

Schemas 72

The contract defines 72 schemas that model the data the API accepts and returns. The most detailed are ExperimentItem (23 properties), ExperimentItem_Compare (22 properties), Dataset_Public (20 properties), DatasetVersion_Public (18 properties). Each schema is shown below with its type and property counts.

JsonNode_Public
object
EvaluatorItem_Compare
object
3 properties 3 required
DatasetVersionDiff
object
3 properties
ErrorMessage_Public
object
3 properties
JsonNode_Compare
object
DatasetItemChanges_Public
object
Comment_Compare
object
6 properties 1 required
ExperimentItem_Compare
object
22 properties 3 required
DatasetExpansionResponse
object
4 properties
JsonNode
object
ValueEntry
object
7 properties
EvaluatorItem
object
3 properties 3 required
TraceEnrichmentOptions
object
Options for enriching trace data
6 properties
ExecutionPolicy_Write
object
2 properties
SpanEnrichmentOptions
object
Options for enriching span data
5 properties
AssertionResult_Compare
object
3 properties
PageColumns
object
1 property
ErrorMessage
object
3 properties
ProjectStats_Public
object
1 property
CreateDatasetItemsFromSpansRequest
object
4 properties 2 required
ExperimentRunSummary_Compare
object
3 properties
DatasetVersionSummary_Public
object
Summary of the latest dataset version
5 properties
DatasetIdentifier
object
2 properties 1 required
JsonListString
object
DatasetItemsDelete
object
Request to delete multiple dataset items
4 properties
Column
object
4 properties
DatasetItemFilter
object
Filters to select dataset items to delete within the specified dataset. Must be used with 'datasetid'. Mutually exclusive with 'itemids'. Empty array means 'de…
4 properties
EvaluatorItem_Public
object
Default evaluators for items in this version
3 properties 3 required
EvaluatorItem_Write
object
3 properties 3 required
DatasetItemUpdate
object
Dataset item update request
11 properties
DatasetItem_Compare
object
17 properties 2 required
JsonListString_Compare
object
ExecutionPolicy
object
2 properties
DatasetVersionRetrieveRequest_Public
object
1 property 1 required
DatasetVersionUpdate_Public
object
2 properties
Dataset_Write
object
8 properties 1 required
CreateDatasetItemsFromTracesRequest
object
4 properties 2 required
DatasetVersionDiffStats
object
4 properties
DatasetItemBatch_Write
object
8 properties 1 required
DatasetItemPage_Public
object
6 properties
Dataset_Public
object
20 properties 1 required
ExperimentRunSummary_Public
object
3 properties
ExperimentRunSummary
object
3 properties
ExecutionPolicy_Public
object
Default execution policy for items in this version
2 properties
DatasetUpdate
object
4 properties 1 required
DatasetItem
object
17 properties 2 required
DatasetItemPage_Compare
object
6 properties
AssertionResult
object
3 properties
Comment
object
6 properties 1 required
ExperimentItem_Public
object
10 properties 3 required
DatasetExpansion_Write
object
6 properties 1 required
Column_Public
object
4 properties
ValueEntry_Compare
object
7 properties
Column_Compare
object
4 properties
DatasetExportJob_Public
object
12 properties
BatchDelete
object
1 property 1 required
DatasetVersionTag
object
1 property 1 required
DatasetVersion_Public
object
18 properties
DatasetIdentifier_Public
object
2 properties 1 required
DatasetPage_Public
object
5 properties
DatasetItemBatchUpdate
object
Request to batch update multiple dataset items
5 properties 1 required
ProjectStatItemObject_Public
object
2 properties
FeedbackScore_Compare
object
10 properties 3 required
ExperimentItem
object
23 properties 3 required
FeedbackScore
object
10 properties 3 required
DatasetVersionPage_Public
object
4 properties
JsonNode_Write
object
ExecutionPolicy_Compare
object
2 properties
DatasetItem_Write
object
9 properties 2 required
DatasetItemStreamRequest
object
6 properties 1 required
DatasetVersionRestore_Public
object
1 property 1 required
DatasetItem_Public
object
17 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

opik-datasets-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 Environments API
AE Profile APIs.io
Opik Experiments API
AE Profile APIs.io
#Datasets
← Back to O APIs
API Details
ID
opik:opik-datasets-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-datasets-api&limit=10"
Everything under a tag 
curl "https://api.apievangelist.com/v1/tags/opik-datasets-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 Datasets 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.