Upload a Document

Documents are uploaded to a specific schema within a workspace. Each document is scoped to an environment (defaults to production).

Upload a file

Pass a Blob or File object to the SDK:

import { readFileSync } from "node:fs";

const file = new Blob([readFileSync("./invoice.pdf")], {
  type: "application/pdf",
});

const document = await client.documents.create("my-workspace", "invoice", {
  file,
  fileName: "invoice.pdf",
});

console.log(document.id); // "doc_abc123"
console.log(document.pageCount); // 3

Upload text content

For plain text or pre-processed content, you can upload a string directly:

const document = await client.documents.create("my-workspace", "invoice", {
  content: "Invoice #1234\nDate: 2024-03-15\nTotal: $1,250.00",
  fileName: "invoice.txt",
});

Upload with curl

curl -X POST https://api.tracore.io/workspaces/my-workspace/schemas/invoice/documents \
  -H "x-api-key: dsk_your_api_key_here" \
  -F "file=@invoice.pdf"

Environment scoping

Documents are scoped to an environment. Pass the env parameter to target a specific one:

// Upload to the development environment
const document = await client.documents.create("my-workspace", "invoice", {
  file,
  fileName: "invoice.pdf",
  env: "development",
});

# Upload to staging via curl
curl -X POST "https://api.tracore.io/workspaces/my-workspace/schemas/invoice/documents?env=staging" \
  -H "x-api-key: dsk_your_api_key_here" \
  -F "file=@invoice.pdf"

If omitted, the environment defaults to production.

Inline upload and extract

You can upload a document and start extraction in a single request using the extract endpoint. See Extract & Poll for details.