curl -X POST 'https://api.anyformat.ai/v3/workflows/0686bb97-8c30-70f0-8000-97669e000eb8/dataset/upload/' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Idempotency-Key: 5f2b6c3e-8a1d-4f7e-9c0b-1a2b3c4d5e6f' \
  -F 'files=@/path/to/invoice_001.pdf' \
  -F 'ground_truth={"invoice_no": "INV-1", "total": "90.00"}'

from anyformat.sdk import Client, DatasetDocument

client = Client(api_key="YOUR_API_KEY")
workflow_id = "0686bb97-8c30-70f0-8000-97669e000eb8"

# One document with ground truth.
upload = client.upload_to_dataset(
    workflow_id,
    "invoice_001.pdf",
    ground_truth={"invoice_no": "INV-1", "total": "90.00"},
)
print(upload.document_packet_id, upload.ground_truth_saved)

# Bulk: one atomic call per document.
uploads = client.upload_documents_to_dataset(
    workflow_id,
    [
        DatasetDocument(file="invoice_001.pdf", ground_truth={"invoice_no": "INV-1"}),
        DatasetDocument(file="invoice_002.pdf", ground_truth={"invoice_no": "INV-2"}),
    ],
)

interface DatasetUpload {
  document_packet_id: string;
  files: { id: string; name: string; original_name: string | null }[];
  ground_truth_saved: boolean;
}

const workflowId = '0686bb97-8c30-70f0-8000-97669e000eb8';
const formData = new FormData();
formData.append('files', fileInput.files[0]);
formData.append('ground_truth', JSON.stringify({ invoice_no: 'INV-1', total: '90.00' }));

const response = await fetch(
  `https://api.anyformat.ai/v3/workflows/${workflowId}/dataset/upload/`,
  {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY',
      'Idempotency-Key': crypto.randomUUID(),
    },
    body: formData,
  }
);

if (!response.ok) {
  throw new Error(`API error: ${response.status}`);
}

const upload: DatasetUpload = await response.json();
console.log(upload.document_packet_id, upload.ground_truth_saved);

{
  "document_packet_id": "069dcc2c-e14c-7606-8000-2ee4fb17b4e1",
  "files": [
    { "id": "069dcc2c-e14c-7606-8000-2ee4fb17b4e2", "name": "invoice_001.pdf", "original_name": null }
  ],
  "ground_truth_saved": true
}