---
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' | 'geo' | 'combined' — 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

## Changes

- **2026-08-26** `c44f51a92d95` — 2 info
  - added the new `combined` enum value to the request property `type`
  - added the new `geo` enum value to the request property `type`
- **2026-08-14** `c6b2fabd21be` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/snowseo/apis/snowseo-api/changes/v3/pdf/jobs/post.md)

---

[API](https://skmtc.dev/snowseo/apis/snowseo-api.md) · [All operations](https://skmtc.dev/snowseo/apis/snowseo-api/llms.txt) · [OpenAPI document](https://skmtc.dev/snowseo/apis/snowseo-api/revisions/992a8ecadda0?raw)