pitch2pdf for AI agents

What an agent can do without a human

• Convert any supported public link — Pitch, DocSend, Google Slides, Google Drive, Google Docs, Google Sheets, Canva, Prezi, Presentations.AI, Figma Slides, or a direct link to a PDF — with POST /api/convert. No key, no login.
• Download the free preview: the first 10 slides at full resolution, as a PDF, from the downloadUrl the conversion returns.
• Read the job with GET /api/jobs/{jobId}/results, which reports the slide count, the preview URL, and agentPaymentsAvailable — whether the server will accept a machine payment right now.
• Buy the full deck for $3 by paying the 402 challenge on POST /api/jobs/{jobId}/generate-paid, then download it in the size it asked for. The amount is fixed by the server and never read from the request.

The three requests

Everything below is plain HTTP against https://api.pitch2pdf.com. Long values are elided with ….

1. Convert. The stream ends with an event: complete that carries the jobId and the free preview:

curl -N -X POST https://api.pitch2pdf.com/api/convert \
  -F url=https://pitch.com/v/your-deck

event: progress
data: {"status":"processing","stage":"capturing","currentSlide":3,"totalSlides":24}

event: complete
data: {"status":"completed","jobId":"job_1788…","numSlides":24,"serviceName":"Pitch","downloadUrl":"https://…/free.pdf"}

2. Ask for the full deck. Unpaid, the server answers 402 with the payment challenge in the headers and a JSON body:

curl -i -X POST https://api.pitch2pdf.com/api/jobs/job_1788…/generate-paid \
  -H 'Content-Type: application/json' -d '{"size":"medium"}'

HTTP/1.1 402 Payment Required
WWW-Authenticate: Payment id="…", realm="api.pitch2pdf.com", method="stripe", intent="charge", request="…", opaque="…"
WWW-Authenticate: Payment id="…", realm="api.pitch2pdf.com", method="tempo", intent="charge", request="…", opaque="…"
PAYMENT-REQUIRED: eyJ4NDAyVmVyc2lvbiI6Miw…   (base64 x402 v2 requirements: USDC on Base)
Cache-Control: no-store
Content-Type: application/json

{"code":"PAYMENT_REQUIRED","error":"Payment required to generate the paid PDF","jobId":"job_1788…","amountUsd":3,"rails":["spt","x402","tempo"],"docs":"https://www.pitch2pdf.com/agents"}

3. Retry the same request with the credential. The server verifies and settles the payment first, returns a receipt, then streams the PDF build:

curl -N -X POST https://api.pitch2pdf.com/api/jobs/job_1788…/generate-paid \
  -H 'Content-Type: application/json' -d '{"size":"medium"}' \
  -H 'Authorization: Payment <credential>'        # MPP (card via Link, or USDC on Tempo)
  # or, for x402:  -H 'PAYMENT-SIGNATURE: <signed payment payload>'

HTTP/1.1 200 OK
Payment-Receipt: …
PAYMENT-RESPONSE: …                                 # x402 requests only
Content-Type: text/event-stream

event: progress
data: {"stage":"ocr","current":5,"total":24}

event: complete
data: {"downloadUrl":"https://…/medium.pdf","size":"medium"}

Progress stages are starting, ocr, building and uploading; a 30-slide deck takes about a minute and a 120-slide deck five to ten. If the PDF for that size already exists the response is plain JSON instead of a stream: {"downloadUrl":"…","size":"medium","cached":true}. A rejected credential answers 402 again with "code":"PAYMENT_INVALID" and a fresh challenge.

Paying

The 402 advertises every rail the server accepts; the agent pays on whichever one it holds funds for. All of them charge the same $3.

One line with mppx, which reads the challenge and pays on any rail it is configured for:

npx mppx@latest https://api.pitch2pdf.com/api/jobs/<jobId>/generate-paid -X POST --json '{"size":"medium"}'

Price and what it unlocks

$3 per deck, the same as the one-time unlock a person buys on the results page. The amount is set by the server and pinned into the challenge, so a credential minted for one job at one amount is refused on any other. One payment unlocks:

• every slide at full resolution — no 10-slide preview limit;
• an invisible OCR text layer, so the PDF is searchable and copy-pasteable and readable by the next agent in the chain;
• all three sizes — small, medium, large — built on request and cached, so asking for a second size costs nothing;
• a free re-capture of the same deck for seven days if the source changes, the same "refresh" a person gets.

Discovery

A machine-readable description of the API — every endpoint, the 402 response, both challenge headers and the price as MPP x-payment-info — is published as OpenAPI 3.1 at https://api.pitch2pdf.com/openapi.json. npx mppx@latest validate https://api.pitch2pdf.com reads it. A prose summary for language models is at /llms.txt (full version: /llms-full.txt).

Errors

Conversion failures (a private deck, an unsupported link, a dead link) come back on the /api/convert stream as event: error with the same code values the CLI documents.

Refunds and support

Agent purchases are refunded under the same policy as purchases made by a person: if the full PDF is unusable or never arrived, email support@pitch2pdf.com with the jobId (and the Payment-Receipt if you have it). Refunds go back to the card or wallet that paid.