Export Training Dataset

GET

api

training-datasets

{dataset_id}

export

cURL

curl --request GET \
  --url https://labs.tacitintelligence.co/api/v1/training-datasets/{dataset_id}/export \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://labs.tacitintelligence.co/api/v1/training-datasets/{dataset_id}/export"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://labs.tacitintelligence.co/api/v1/training-datasets/{dataset_id}/export', 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://labs.tacitintelligence.co/api/v1/training-datasets/{dataset_id}/export",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "https://labs.tacitintelligence.co/api/v1/training-datasets/{dataset_id}/export"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://labs.tacitintelligence.co/api/v1/training-datasets/{dataset_id}/export")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://labs.tacitintelligence.co/api/v1/training-datasets/{dataset_id}/export")

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

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

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

{
  "row_count": 0,
  "message": "<string>",
  "error": "<string>"
}

{
  "error": "<string>",
  "details": {}
}

The schema below documents the non-ready response branches (202 / 409 / 500) only. When status='ready' this endpoint streams application/x-ndjson instead, with one DeepSeek-R1-shape row per line. See Training Datasets concept page for the full NDJSON row shape and the canonical token reference.

Worked example

A single NDJSON line from a successful export looks like this:

{"scenario_id":"...","agent_template_id":"...","messages":[{"role":"user","content":"Hi Luke, here's my update for week 3..."},{"role":"assistant","content":"<no_response/>"}],"metadata":{"temperature":0.7,"rollout_index":0,"turn_count":1,"quality_score":0.84,"complexity_score":0.62,"ifd_score":null}}

The <no_response/> token is emitted whenever the operator deliberately chose silence at a reach-out moment. It is a first-class learnable target, not an absence of data. See the token reference for the full table.

Polling pattern

# 1. Poll status until ready
curl -H "Authorization: Bearer $LABS_KEY" \
  "$LABS_URL"/api/v1/training-datasets/$ID/status

# 2. When status='ready', download the NDJSON
curl -H "Authorization: Bearer $LABS_KEY" \
  -o dataset.jsonl \
  "$LABS_URL"/api/v1/training-datasets/$ID/export

Response headers on the success branch:

Header	Meaning
`Content-Type`	`application/x-ndjson`
`Content-Disposition`	`attachment; filename="training-dataset-{id}.jsonl"`
`X-Row-Count`	Number of rows in the body
`X-Request-ID`	Echo of the request ID for correlation
`X-RateLimit-*`	Standard rate-limit headers (see Authentication)

Authorizations

Authorization

string

header

required

API key obtained from Labs Portal

Path Parameters

dataset_id

string<uuid>

required

Training dataset UUID

Pattern:

^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$

Response

Success

status

enum<string>

required

Lifecycle status. The 200 NDJSON path is only served when status=ready.

Available options:

pending,

preview,

running,

filtering,

cancelled,

failed

row_count

integer | null

required

Completed rows so far. Null until finalised.

Required range: -9007199254740991 <= x <= 9007199254740991

message

string

required

Human-readable explanation

error

string

Stored error string when status=failed

Get Training Dataset StatusPoll a training dataset for lifecycle status and current row count. Cheap to call repeatedly.

cURL

curl --request GET \
  --url https://labs.tacitintelligence.co/api/v1/training-datasets/{dataset_id}/export \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://labs.tacitintelligence.co/api/v1/training-datasets/{dataset_id}/export"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://labs.tacitintelligence.co/api/v1/training-datasets/{dataset_id}/export', 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://labs.tacitintelligence.co/api/v1/training-datasets/{dataset_id}/export",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "https://labs.tacitintelligence.co/api/v1/training-datasets/{dataset_id}/export"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://labs.tacitintelligence.co/api/v1/training-datasets/{dataset_id}/export")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://labs.tacitintelligence.co/api/v1/training-datasets/{dataset_id}/export")

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

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

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

{
  "row_count": 0,
  "message": "<string>",
  "error": "<string>"
}

{
  "error": "<string>",
  "details": {}
}

Overview

Catalog

Episodes

Evaluation

Key

Training Datasets

Export Training Dataset

Worked example

Polling pattern

Authorizations

Path Parameters

Response

​Worked example

​Polling pattern

Authorizations

Path Parameters

Response

Worked example

Polling pattern