Skip to main content
POST
Connect dataset source

Authorizations

Authorization
string
header
required

API key with the vk_ prefix. Create one from the dashboard.

Body

application/json
name
string
required
source_type
string
required
huggingface_dataset
string | null
huggingface_config
any
volume
string | null
volume_path
string | null
credentials
any

Response

A dataset with this name and the same source already exists: that dataset

object
string
required
id
string
required
name
string
required
created_at
string<date-time>
required
source_type
string
source_uri
string | null
huggingface_dataset
string | null
num_rows
integer<int32> | null
format
string | null

Row format. A stream's locked format (prompt | preference | completion | chat | eval); an upload records its first row's shape, which adds chat_no_prompt (chat rows without a prompt, still locked as chat), text, sharegpt and alpaca (no lock). Job submit refuses GRPO on chat_no_prompt, text, sharegpt and alpaca rows. Null on Hugging Face / volume sources, and on a legacy dataset until its first append locks it.

head_row
integer<int64>

Highest row_id appended so far (0 = empty stream). Includes supersede and tombstone entries, so it is the log length, not the live row count.

auto_snapshot_rows
integer<int32> | null

"cut a snapshot every N new rows" rule; null = off.

latest_snapshot_id
string | null

Newest snapshot id ("@snap-N"); populated by GET /v1/datasets/{id}.

unsnapshotted_rows
integer<int64> | null

Rows appended since the newest snapshot; populated by GET /v1/datasets/{id}.

snapshot_count
integer<int64> | null