Add or replace dataset entries

curl --request POST \
  --url https://forge.coreweave.com/api/distillation/v1/projects/{alias}/datasets/{datasetId}/entries \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
[
  {
    "messages": [
      {}
    ],
    "row_id": "<string>",
    "group_id": "<string>",
    "tools": [
      {
        "type": "function",
        "function": {
          "name": "<string>",
          "description": "<string>",
          "parameters": {},
          "strict": true
        }
      }
    ],
    "tool_choice": "<unknown>",
    "response_format": "<unknown>",
    "metadata": {},
    "provenance": {}
  }
]
'

import requests

url = "https://forge.coreweave.com/api/distillation/v1/projects/{alias}/datasets/{datasetId}/entries"

payload = [
    {
        "messages": [{}],
        "row_id": "<string>",
        "group_id": "<string>",
        "tools": [
            {
                "type": "function",
                "function": {
                    "name": "<string>",
                    "description": "<string>",
                    "parameters": {},
                    "strict": True
                }
            }
        ],
        "tool_choice": "<unknown>",
        "response_format": "<unknown>",
        "metadata": {},
        "provenance": {}
    }
]
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify([
    {
      messages: [{}],
      row_id: '<string>',
      group_id: '<string>',
      tools: [
        {
          type: 'function',
          function: {name: '<string>', description: '<string>', parameters: {}, strict: true}
        }
      ],
      tool_choice: '<unknown>',
      response_format: '<unknown>',
      metadata: {},
      provenance: {}
    }
  ])
};

fetch('https://forge.coreweave.com/api/distillation/v1/projects/{alias}/datasets/{datasetId}/entries', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://forge.coreweave.com/api/distillation/v1/projects/{alias}/datasets/{datasetId}/entries",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    [
        'messages' => [
                [
                                
                ]
        ],
        'row_id' => '<string>',
        'group_id' => '<string>',
        'tools' => [
                [
                                'type' => 'function',
                                'function' => [
                                                                'name' => '<string>',
                                                                'description' => '<string>',
                                                                'parameters' => [
                                                                                                                                
                                                                ],
                                                                'strict' => true
                                ]
                ]
        ],
        'tool_choice' => '<unknown>',
        'response_format' => '<unknown>',
        'metadata' => [
                
        ],
        'provenance' => [
                
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://forge.coreweave.com/api/distillation/v1/projects/{alias}/datasets/{datasetId}/entries"

	payload := strings.NewReader("[\n  {\n    \"messages\": [\n      {}\n    ],\n    \"row_id\": \"<string>\",\n    \"group_id\": \"<string>\",\n    \"tools\": [\n      {\n        \"type\": \"function\",\n        \"function\": {\n          \"name\": \"<string>\",\n          \"description\": \"<string>\",\n          \"parameters\": {},\n          \"strict\": true\n        }\n      }\n    ],\n    \"tool_choice\": \"<unknown>\",\n    \"response_format\": \"<unknown>\",\n    \"metadata\": {},\n    \"provenance\": {}\n  }\n]")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://forge.coreweave.com/api/distillation/v1/projects/{alias}/datasets/{datasetId}/entries")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("[\n  {\n    \"messages\": [\n      {}\n    ],\n    \"row_id\": \"<string>\",\n    \"group_id\": \"<string>\",\n    \"tools\": [\n      {\n        \"type\": \"function\",\n        \"function\": {\n          \"name\": \"<string>\",\n          \"description\": \"<string>\",\n          \"parameters\": {},\n          \"strict\": true\n        }\n      }\n    ],\n    \"tool_choice\": \"<unknown>\",\n    \"response_format\": \"<unknown>\",\n    \"metadata\": {},\n    \"provenance\": {}\n  }\n]")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://forge.coreweave.com/api/distillation/v1/projects/{alias}/datasets/{datasetId}/entries")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "[\n  {\n    \"messages\": [\n      {}\n    ],\n    \"row_id\": \"<string>\",\n    \"group_id\": \"<string>\",\n    \"tools\": [\n      {\n        \"type\": \"function\",\n        \"function\": {\n          \"name\": \"<string>\",\n          \"description\": \"<string>\",\n          \"parameters\": {},\n          \"strict\": true\n        }\n      }\n    ],\n    \"tool_choice\": \"<unknown>\",\n    \"response_format\": \"<unknown>\",\n    \"metadata\": {},\n    \"provenance\": {}\n  }\n]"

response = http.request(request)
puts response.read_body

{
  "dry_run": true,
  "created": 123,
  "updated": 123,
  "revision": 123,
  "entry_counts": {
    "total": 123,
    "train": 123,
    "val": 123
  },
  "group_conflicts": [
    "<string>"
  ]
}

{
  "error": {
    "message": "Project 'missing' not found in entity 'your-team'",
    "type": "not_found"
  }
}

Add or replace dataset entries

Writes up to 5,000 OpenAI chat rows in one transaction. Send a JSON array, or the same rows as NDJSON (one row per line) with Content-Type: application/x-ndjson. Any invalid row rejects the request and is reported by its index; NDJSON line N is index N - 1. mode=append rejects a row_id that already exists (409 entry_exists); mode=upsert replaces it, keeping the stored group_id, split, metadata, and provenance for any of those the row omits. New entries default to train and their own group. A write that would place one group in more than one split returns 409 group_split_conflict. Writing moves the dataset to a new revision and marks completed relabels and evaluations stale.

POST

projects

{alias}

datasets

{datasetId}

entries

Add or replace dataset entries

curl --request POST \
  --url https://forge.coreweave.com/api/distillation/v1/projects/{alias}/datasets/{datasetId}/entries \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
[
  {
    "messages": [
      {}
    ],
    "row_id": "<string>",
    "group_id": "<string>",
    "tools": [
      {
        "type": "function",
        "function": {
          "name": "<string>",
          "description": "<string>",
          "parameters": {},
          "strict": true
        }
      }
    ],
    "tool_choice": "<unknown>",
    "response_format": "<unknown>",
    "metadata": {},
    "provenance": {}
  }
]
'

import requests

url = "https://forge.coreweave.com/api/distillation/v1/projects/{alias}/datasets/{datasetId}/entries"

payload = [
    {
        "messages": [{}],
        "row_id": "<string>",
        "group_id": "<string>",
        "tools": [
            {
                "type": "function",
                "function": {
                    "name": "<string>",
                    "description": "<string>",
                    "parameters": {},
                    "strict": True
                }
            }
        ],
        "tool_choice": "<unknown>",
        "response_format": "<unknown>",
        "metadata": {},
        "provenance": {}
    }
]
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify([
    {
      messages: [{}],
      row_id: '<string>',
      group_id: '<string>',
      tools: [
        {
          type: 'function',
          function: {name: '<string>', description: '<string>', parameters: {}, strict: true}
        }
      ],
      tool_choice: '<unknown>',
      response_format: '<unknown>',
      metadata: {},
      provenance: {}
    }
  ])
};

fetch('https://forge.coreweave.com/api/distillation/v1/projects/{alias}/datasets/{datasetId}/entries', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://forge.coreweave.com/api/distillation/v1/projects/{alias}/datasets/{datasetId}/entries",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    [
        'messages' => [
                [
                                
                ]
        ],
        'row_id' => '<string>',
        'group_id' => '<string>',
        'tools' => [
                [
                                'type' => 'function',
                                'function' => [
                                                                'name' => '<string>',
                                                                'description' => '<string>',
                                                                'parameters' => [
                                                                                                                                
                                                                ],
                                                                'strict' => true
                                ]
                ]
        ],
        'tool_choice' => '<unknown>',
        'response_format' => '<unknown>',
        'metadata' => [
                
        ],
        'provenance' => [
                
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://forge.coreweave.com/api/distillation/v1/projects/{alias}/datasets/{datasetId}/entries"

	payload := strings.NewReader("[\n  {\n    \"messages\": [\n      {}\n    ],\n    \"row_id\": \"<string>\",\n    \"group_id\": \"<string>\",\n    \"tools\": [\n      {\n        \"type\": \"function\",\n        \"function\": {\n          \"name\": \"<string>\",\n          \"description\": \"<string>\",\n          \"parameters\": {},\n          \"strict\": true\n        }\n      }\n    ],\n    \"tool_choice\": \"<unknown>\",\n    \"response_format\": \"<unknown>\",\n    \"metadata\": {},\n    \"provenance\": {}\n  }\n]")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://forge.coreweave.com/api/distillation/v1/projects/{alias}/datasets/{datasetId}/entries")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("[\n  {\n    \"messages\": [\n      {}\n    ],\n    \"row_id\": \"<string>\",\n    \"group_id\": \"<string>\",\n    \"tools\": [\n      {\n        \"type\": \"function\",\n        \"function\": {\n          \"name\": \"<string>\",\n          \"description\": \"<string>\",\n          \"parameters\": {},\n          \"strict\": true\n        }\n      }\n    ],\n    \"tool_choice\": \"<unknown>\",\n    \"response_format\": \"<unknown>\",\n    \"metadata\": {},\n    \"provenance\": {}\n  }\n]")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://forge.coreweave.com/api/distillation/v1/projects/{alias}/datasets/{datasetId}/entries")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "[\n  {\n    \"messages\": [\n      {}\n    ],\n    \"row_id\": \"<string>\",\n    \"group_id\": \"<string>\",\n    \"tools\": [\n      {\n        \"type\": \"function\",\n        \"function\": {\n          \"name\": \"<string>\",\n          \"description\": \"<string>\",\n          \"parameters\": {},\n          \"strict\": true\n        }\n      }\n    ],\n    \"tool_choice\": \"<unknown>\",\n    \"response_format\": \"<unknown>\",\n    \"metadata\": {},\n    \"provenance\": {}\n  }\n]"

response = http.request(request)
puts response.read_body

{
  "dry_run": true,
  "created": 123,
  "updated": 123,
  "revision": 123,
  "entry_counts": {
    "total": 123,
    "train": 123,
    "val": 123
  },
  "group_conflicts": [
    "<string>"
  ]
}

{
  "error": {
    "message": "Project 'missing' not found in entity 'your-team'",
    "type": "not_found"
  }
}

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

mode

enum<string>

default:append

append rejects rows whose row_id already exists; upsert replaces them.

Available options:

append,

upsert

dry_run

boolean

default:false

Validate and report the change, then roll it back.

Body

Required array length: 1 - 5000 elements

messages

object[]

required

Required array length: 2 - 1000 elements

Show child attributes

row_id

string

Stable identity within the dataset. Upserts match on it. Defaults to a digest of the messages and request fields.

Required string length: 1 - 512

group_id

string

Rows that must share a split, such as the turns of one conversation. Defaults to row_id.

Required string length: 1 - 512

split

enum<string>

train, or val to hold the row out of training for evaluation. New rows default to train.

Available options:

train,

val

tools

object[]

Maximum array length: 128

Show child attributes

tool_choice

any

response_format

any

metadata

object

Filterable attributes, such as the user or customer segment.

Show child attributes

provenance

object

Where the row came from, such as the source system and trace id.

Show child attributes

Response

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

dry_run

boolean

required

created

integer

required

Rows that became new entries.

updated

integer

required

Existing entries the rows replaced.

revision

integer

required

The dataset revision after the write; unchanged by a dry run.

entry_counts

object

required

Show child attributes

group_conflicts

string[]

required

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

Last modified on October 7, 2026