Developer API Specs

Programmatic PDF Compilation

Queue Tectonic LaTeX compilation through the Texva API, with artifacts stored in object storage.

Compilation API

Texva exposes a REST endpoint that enqueues compile jobs. The Rust worker handles Tectonic and writes PDFs back to object storage.

POST

/compile

Queues a compilation job. Returns immediately with the job ID and current status.

Request Headers

Authorization

Bearer <YOUR_TOKEN> (Required)

Content-Type

application/json (Required)

JSON Body Parameters

project_id

UUID (Required). Project used for RLS and artifact access.

input_latex

String (Required). Standard LaTeX source content.

curl Shell Script

curl -X POST "$NEXT_PUBLIC_API_URL/compile" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "project_id": "PROJECT_ID",
    "latex": "\\documentclass{article}\\begin{document}Hello Texva\\end{document}"
  }'

Successful Response Sample

{
  "id": "1c40b6b3-c66c-498e-84ad-74fa929ad78a",
  "status": "Succeeded",
  "pdf_storage_key": "compiles/1c40b6b3/output.pdf",
  "duration_ms": 1528
}