Skip to main content
PATCH
Move dataset entries to a split

Authorizations

Authorization
string
header
required

A wandb API key or wandb JWT. Browser sessions are exchanged by the Model Distillation web app backend; job capabilities are internal only.

Headers

Wandb-Entity
string

Accessible personal or team entity. Omit to use the authenticated user's default entity.

Path Parameters

alias
string
required
Pattern: ^[a-z0-9-]{1,64}$
datasetId
string<uuid>
required

Query Parameters

dry_run
boolean
default:false

Validate and report the change, then roll it back.

Body

application/json
split
enum<string>
required
Available options:
train,
val
filters
object[]

Select entries matching every filter, as in the entry listing.

Maximum array length: 10
row_ids
string[]

Select only these row ids.

Required array length: 1 - 5000 elements
Required string length: 1 - 512
fraction
number

Move only this share of the selected groups, ranked by a digest of the group id so groups stay whole.

Response

Entries were moved, or would be for a dry run.

dry_run
boolean
required
matched
integer
required

Entries selected by the filters, row ids, and fraction.

groups
integer
required

Groups the selected entries belong to.

updated
integer
required

Selected entries that were in a different split.

revision
integer
required

The dataset revision after the change; unchanged by a dry run or a no-op.

entry_counts
object
required
group_conflicts
string[]
required

Groups spanning more than one split. A real change with conflicts is rejected.

Last modified on October 7, 2026