Dataset Workbench

Deliver the kept episodes (THE billing gate)

Export every episode whose FINAL verdict is accept (the machine verdict, flipped where a human overruled it) into the campaign’s delivery archive, optionally publishing to a Hugging Face repo. Returns 202 immediately; poll the campaign’s delivery object (status exporting → exported [→ publishing → published], or failed), then download GET …/export.tar.gz.

You pay for what you take, this is the ONE billing gate. 1 credit per kept episode entering THIS delivery that has never been billed on this campaign, debited atomically from your credits wallet BEFORE the export starts. The paid set persists on the campaign, so a re-deliver only charges episodes added since; concurrent delivers serialize; and a retried delivery finds its ledger receipt instead of paying twice. Only episodes whose render artifacts still exist are exported, and billed (artifacts pruned from disk are never charged for). On insufficient credits the call returns 402 with detail EXACTLY insufficient_credits:need=N (N = the unpaid episode count) and NOTHING is charged or exported. Signed-in identities without a configured wallet backend fail CLOSED (503, delivery disabled).

target_repo (optional) additionally publishes the export to a Hugging Face dataset repo; its namespace must be on the server’s allowlist (403 otherwise; 400 when not namespace/name).

POST

api

workbench

campaigns

{campaign_id}

deliver

Deliver the kept episodes (THE billing gate)

curl --request POST \
  --url https://forge.alakazam.gg/api/workbench/campaigns/{campaign_id}/deliver \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "target_repo": "your-org/augmented-dataset"
}
'

import requests

url = "https://forge.alakazam.gg/api/workbench/campaigns/{campaign_id}/deliver"

payload = { "target_repo": "your-org/augmented-dataset" }
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({target_repo: 'your-org/augmented-dataset'})
};

fetch('https://forge.alakazam.gg/api/workbench/campaigns/{campaign_id}/deliver', 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.alakazam.gg/api/workbench/campaigns/{campaign_id}/deliver",
  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([
    'target_repo' => 'your-org/augmented-dataset'
  ]),
  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.alakazam.gg/api/workbench/campaigns/{campaign_id}/deliver"

	payload := strings.NewReader("{\n  \"target_repo\": \"your-org/augmented-dataset\"\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.alakazam.gg/api/workbench/campaigns/{campaign_id}/deliver")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"target_repo\": \"your-org/augmented-dataset\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://forge.alakazam.gg/api/workbench/campaigns/{campaign_id}/deliver")

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  \"target_repo\": \"your-org/augmented-dataset\"\n}"

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

{
  "status": "exporting",
  "target_repo": "<string>",
  "billed_episodes": 123
}

{
  "detail": "<string>",
  "errors": [
    "<string>"
  ],
  "schemaVersion": "<string>"
}

{
  "detail": "<string>",
  "errors": [
    "<string>"
  ],
  "schemaVersion": "<string>"
}

{
  "detail": "<string>",
  "errors": [
    "<string>"
  ],
  "schemaVersion": "<string>"
}

{
  "detail": "<string>",
  "errors": [
    "<string>"
  ],
  "schemaVersion": "<string>"
}

{
  "detail": "<string>",
  "errors": [
    "<string>"
  ],
  "schemaVersion": "<string>"
}

{
  "detail": "<string>",
  "errors": [
    "<string>"
  ],
  "schemaVersion": "<string>"
}

{
  "detail": "<string>",
  "errors": [
    "<string>"
  ],
  "schemaVersion": "<string>"
}

Authorizations

Authorization

string

header

required

Either a Supabase user access token (from a password login, or the passwordless magic-link flow) or a long-lived forge_sk_… API key. Both are sent as Authorization: Bearer <value> and resolve to the same owner, so every endpoint accepts either. Session tokens expire in ~1h; API keys do not expire and are the credential for MCP clients, CI, and partner integrations.

Path Parameters

campaign_id

string

required

Body

application/json

target_repo

string | null

Optional Hugging Face repo (namespace/name) to publish to. Omit (or send empty) to only export server-side for the tar.gz download.

Example:

"your-org/augmented-dataset"

Response

Delivery started (billing already settled). billed_episodes is how many episodes THIS call billed, 0 when everything entering the export was already paid for on an earlier delivery (or for the free local dev tenant).

status

string

Example:

"exporting"

target_repo

string | null

billed_episodes

integer

Episodes newly billed by this delivery (1 credit each).

Deliver the kept episodes (THE billing gate)

curl --request POST \
  --url https://forge.alakazam.gg/api/workbench/campaigns/{campaign_id}/deliver \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "target_repo": "your-org/augmented-dataset"
}
'

import requests

url = "https://forge.alakazam.gg/api/workbench/campaigns/{campaign_id}/deliver"

payload = { "target_repo": "your-org/augmented-dataset" }
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({target_repo: 'your-org/augmented-dataset'})
};

fetch('https://forge.alakazam.gg/api/workbench/campaigns/{campaign_id}/deliver', 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.alakazam.gg/api/workbench/campaigns/{campaign_id}/deliver",
  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([
    'target_repo' => 'your-org/augmented-dataset'
  ]),
  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.alakazam.gg/api/workbench/campaigns/{campaign_id}/deliver"

	payload := strings.NewReader("{\n  \"target_repo\": \"your-org/augmented-dataset\"\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.alakazam.gg/api/workbench/campaigns/{campaign_id}/deliver")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"target_repo\": \"your-org/augmented-dataset\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://forge.alakazam.gg/api/workbench/campaigns/{campaign_id}/deliver")

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  \"target_repo\": \"your-org/augmented-dataset\"\n}"

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

{
  "status": "exporting",
  "target_repo": "<string>",
  "billed_episodes": 123
}

{
  "detail": "<string>",
  "errors": [
    "<string>"
  ],
  "schemaVersion": "<string>"
}

{
  "detail": "<string>",
  "errors": [
    "<string>"
  ],
  "schemaVersion": "<string>"
}

{
  "detail": "<string>",
  "errors": [
    "<string>"
  ],
  "schemaVersion": "<string>"
}

{
  "detail": "<string>",
  "errors": [
    "<string>"
  ],
  "schemaVersion": "<string>"
}

{
  "detail": "<string>",
  "errors": [
    "<string>"
  ],
  "schemaVersion": "<string>"
}

{
  "detail": "<string>",
  "errors": [
    "<string>"
  ],
  "schemaVersion": "<string>"
}

{
  "detail": "<string>",
  "errors": [
    "<string>"
  ],
  "schemaVersion": "<string>"
}

Play API

Forge API

Train API

Deliver the kept episodes (THE billing gate)

Authorizations

Path Parameters

Body

Response