API Reference

Datasets

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Combine

Combine multiple Datasets into a single new merged Dataset

POST/api/v1/datasets/combine

Validate that a set of Datasets can be combined

POST/api/v1/datasets/combine/validate

ModelsExpand Collapse

CombineCreateResponse = object { dataset_id } or object { combine_job_id, status, dataset_id, error_message }

One of the following:

CombineResponseDto object { dataset_id }

dataset_id: string

The newly created merged Dataset’s ID. Returns existing ID on idempotent replay.

CombineJobResponseDto object { combine_job_id, status, dataset_id, error_message }

combine_job_id: string

Background combine job ID. Poll the combine job status endpoint until it succeeds or fails.

status: "queued" or "running" or "succeeded" or "failed"

Current background combine job status.

One of the following:

"queued"

"running"

"succeeded"

"failed"

dataset_id: unknown

The merged Dataset ID. Null until the background combine succeeds.

error_message: unknown

Customer-safe failure message when the background combine fails.

CombineJobs

Get the status of a background dataset combine job

GET/api/v1/datasets/combine/jobs/{combine_job_id}

ModelsExpand Collapse

JobGetResponse object { combine_job_id, status, dataset_id, error_message }

combine_job_id: string

Background combine job ID. Poll the combine job status endpoint until it succeeds or fails.

status: "queued" or "running" or "succeeded" or "failed"

Current background combine job status.

One of the following:

"queued"

"running"

"succeeded"

"failed"

dataset_id: unknown

The merged Dataset ID. Null until the background combine succeeds.

error_message: unknown

Customer-safe failure message when the background combine fails.