---
title: "Queue a PDF export"
method: POST
path: "/v3/pdf/jobs"
tags: ["PDF Export"]
---

# Queue a PDF export

`POST /v3/pdf/jobs`

Stores the export payload, enqueues a render job and returns a job id to poll. Renders SEO-audit and PageSpeed reports alike - `type` selects the document. Async because a large render exceeds the 100s edge timeout.

## Request body

- object
  - `action` 'download' | 'share' | 'email', required — What to do with the rendered PDF. `download` and `share` return a URL from the status endpoint; `email` sends it as an attachment.
  - `type` 'page' | 'overview' | 'page-speed-page' | 'page-speed-overview' — Which document to render.
  - `data` object, required — Payload — shape depends on `type`. Must include `pageUrl` (use the base URL for overview variants).
  - `email` string, email — Recipient address. Required when `action` is `email`.
  - `teamId` string — Team that owns the audit. Membership is enforced by checkMembership.
  - `whiteLabel` boolean — Apply the org's white-label brand mark when entitled.

## Response `202`

Default Response

- object
  - `jobId` string
  - `status` string

## Other responses

- `400` — Default Response
- `413` — Default Response

---

[API](https://skmtc.net/snowseo/apis/snowseo-api.md) · [All operations](https://skmtc.net/snowseo/apis/snowseo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/snowseo/snowseo-api/revisions/c8f1f876a92c/schema)