Exports

Every successful render job produces downloadable artifacts. You can retrieve them from the dashboard UI, the job detail API, or directly via artifact URLs stored on the job record.

Artifact Types

All formats (PPTX, DOCX, PDF) are available on every plan tier.

Downloading from the Dashboard

After a render completes, the job detail view shows the generated PPTX and slide previews. Click the download button to save the file locally.

In the playground at /playground, the Download PPTX button saves the file as playground.pptx.

Downloading via API

The job record includes download_url and preview_url fields. Fetch the job and follow the URLs:

# Get the job record
curl https://api.paperjsx.com/api/v2/jobs/JOB_ID \
  -H "Authorization: Bearer pj_live_YOUR_KEY"

# The response includes:
# "download_url": "/storage/v1/object/public/renders/org_abc/job_123/output.pptx"
# "preview_url": "/storage/v1/object/public/renders/org_abc/job_123/preview-0.png"

The artifacts array on the job detail provides a complete inventory with kind, storage_path, public_url, content_type, and byte_length for each artifact.

Artifact Inventory

The job detail endpoint (GET /api/v2/jobs/:id) returns an artifacts section listing every stored artifact:

{
  "artifacts": [
    {
      "kind": "generated_pptx",
      "label": "output.pptx",
      "public_url": "https://...",
      "content_type": "application/vnd.openxmlformats-officedocument.presentationml.presentation",
      "byte_length": 48210
    },
    {
      "kind": "preview_png",
      "label": "slide-1.png",
      "public_url": "https://...",
      "byte_length": 12800
    }
  ]
}

Storage and Retention

Artifacts are stored in the platform's object storage (Supabase Storage). Files remain available for download as long as the render job record exists. There is no automatic expiration of artifacts.

File Naming

• PPTX files: named after the document_title from the render payload when downloaded from the dashboard, or output.pptx in storage.
• Preview images: preview-{index}.png, one per slide.
• Playground exports: always playground.pptx.

Next Steps

• Render Jobs -- understand the job lifecycle and how artifacts are produced
• Review Loop -- review artifacts before delivering them downstream
• Webhooks -- get notified when artifacts are ready