Skip to main content
GET
Python (SDK)

Authorizations

Authorization
string
header
required

Gateway auth: send Authorization: Bearer <mka1-api-key>. For multi-user server-side integrations, you can also send X-On-Behalf-Of: <external-user-id>.

Headers

X-On-Behalf-Of
string

Optional external end-user identifier forwarded by the API gateway.

Path Parameters

dataset_id
string
required

Response

Successful Response

A first-class training dataset: a registered reference or an uploaded, committed object set.

created_at
string<date-time>
required
id
string
required
kind
enum<string>
required

How the data is sourced: an opaque external reference the trainer resolves itself, an uploaded object served to the trainer via a presigned fetch URL minted at provider hand-off, or a repo:// reference reserved for the versioned dataset store.

Available options:
external,
upload,
repo
name
string
required
size_bytes
integer
required

Total committed bytes; 0 for references and uncommitted uploads.

status
enum<string>
required

pending_upload until an uploaded dataset is committed; deleting while asynchronous object removal is in progress.

Available options:
pending_upload,
ready,
deleting
manifest
DatasetManifest · object | null

Immutable record of an uploaded dataset's objects, written once at commit.

revision
string | null

The pinned revision parsed from a repo:// source; null otherwise.

source
string | null

The registered source reference for external and repo datasets; null for uploads.

upload
DatasetUpload · object | null

Presigned upload targets for an upload-mode dataset.