The document endpoint
for AI agents.

const documentData = {
  schemaVersion: "ptp.document/1",
  title: "AI-generated service report",
  locale: "en-US",
  paper: { size: "A4", orientation: "portrait" },
  template: "work_report",
  blocks: [
    { type: "heading", level: 1, text: "Service report" },
    { type: "paragraph", text: "Prepared by an AI assistant." },
    { type: "list", style: "bullet", items: ["Inspection complete", "No defects found"] }
  ]
};

const response = await fetch("https://www.pastetoprint.com/api/v2/documents", {
  method: "POST",
  headers: {
    "Content-Type": "application/vnd.pastetoprint.ptdf+json",
    "Idempotency-Key": `ai-${crypto.randomUUID()}`
  },
  body: JSON.stringify(documentData)
});

if (!response.ok) throw new Error(`PasteToPrint API: ${response.status}`);
const result = await response.json();
console.log(result.editorUrl); // Give this temporary URL to the user.

<?php
$document = [
    'schemaVersion' => 'ptp.document/1',
    'title' => 'AI-generated service report',
    'locale' => 'en-US',
    'paper' => ['size' => 'A4', 'orientation' => 'portrait'],
    'template' => 'work_report',
    'blocks' => [
        ['type' => 'heading', 'level' => 1, 'text' => 'Service report'],
        ['type' => 'paragraph', 'text' => 'Prepared by an AI assistant.'],
        ['type' => 'list', 'style' => 'bullet', 'items' => ['Inspection complete', 'No defects found']],
    ],
];

$curl = curl_init('https://www.pastetoprint.com/api/v2/documents');
curl_setopt_array($curl, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Content-Type: application/vnd.pastetoprint.ptdf+json',
        'Idempotency-Key: ai-' . bin2hex(random_bytes(12)),
    ],
    CURLOPT_POSTFIELDS => json_encode($document, JSON_THROW_ON_ERROR),
]);

$response = curl_exec($curl);
if ($response === false) throw new RuntimeException(curl_error($curl));
$result = json_decode($response, true, 512, JSON_THROW_ON_ERROR);
echo $result['editorUrl']; // Give this temporary URL to the user.

import json
import uuid
from urllib.request import Request, urlopen

document = {
    "schemaVersion": "ptp.document/1",
    "title": "AI-generated service report",
    "locale": "en-US",
    "paper": {"size": "A4", "orientation": "portrait"},
    "template": "work_report",
    "blocks": [
        {"type": "heading", "level": 1, "text": "Service report"},
        {"type": "paragraph", "text": "Prepared by an AI assistant."},
        {"type": "list", "style": "bullet", "items": ["Inspection complete", "No defects found"]},
    ],
}

request = Request(
    "https://www.pastetoprint.com/api/v2/documents",
    data=json.dumps(document).encode("utf-8"),
    method="POST",
    headers={
        "Content-Type": "application/vnd.pastetoprint.ptdf+json",
        "Idempotency-Key": f"ai-{uuid.uuid4()}",
    },
)

with urlopen(request, timeout=15) as response:
    result = json.load(response)
    print(result["editorUrl"])  # Give this temporary URL to the user.

curl --request POST "https://www.pastetoprint.com/api/v2/documents" \
  --header "Content-Type: application/vnd.pastetoprint.ptdf+json" \
  --header "Idempotency-Key: ai-demo-$(date +%s)-$RANDOM" \
  --data '{
    "schemaVersion": "ptp.document/1",
    "title": "AI-generated service report",
    "locale": "en-US",
    "paper": { "size": "A4", "orientation": "portrait" },
    "template": "work_report",
    "blocks": [
      { "type": "heading", "level": 1, "text": "Service report" },
      { "type": "paragraph", "text": "Prepared by an AI assistant." },
      { "type": "list", "style": "bullet", "items": ["Inspection complete", "No defects found"] }
    ]
  }'