/api/v1/disk/store-pdf

Generates a PDF from provided HTML using the BizKitHub PDF generator parameters, stores it in blob storage, and returns a public download URL.

Sizing priority: width overrides format. Optional height makes page size explicit. autoHeight enables print-safe margins; margin overrides them. fitHeight enables single-page receipt mode.

diskdiskStorePdf

Parameters

12 body

12 total

Body · 12

htmlContentstringRequired

HTML content to render into PDF. This is sent as the generator request body (compressed).

filenamestringRequired

Original filename. The service normalizes it, appends a random suffix, and forces the .pdf extension.

tagstring

Optional storage tag (internal metadata label).

formatstring

Standard paper format (e.g. A4, Letter, …). Used when width is not set. Default is A4.

widthstring

Custom page width (CSS length, e.g. 80mm, 210mm, 800px). When set, it overrides format.

heightstring

Custom page height (CSS length). Used in fixed-size mode. When width is set and fitHeight is not enabled, height defaults like A4 height behavior.

autoHeightboolean

Enables print-safe margins consistently across pages (improves page breaks and prevents edge clipping).

marginstring

Overrides margin size when autoHeight=true. CSS shorthand (1–4 values), e.g. "12mm 10mm" or "2mm".

fitHeightboolean

Receipt mode: generates a single-page PDF whose height is derived from rendered content. Works best with width (e.g. 80mm).

uuidstring

Optional identifier stored in PDF metadata keywords.

authorstring

Optional author label in PDF metadata (Author/Creator/Producer). If omitted, defaults to organisation name.

debugboolean

Adds debug CSS borders to the rendered HTML for layout inspection (internal).

Request

POST /api/v1/disk/store-pdf

post

curl -X POST "https://api.bizkithub.com/api/v1/disk/store-pdf" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "htmlContent": "<!doctype html><html><body><h1>Invoice #123</h1></body></html>",
  "filename": "invoice-123.pdf",
  "tag": "invoice",
  "format": "A4",
  "width": "80mm",
  "height": "150mm",
  "autoHeight": true,
  "margin": "12mm 10mm",
  "fitHeight": true,
  "uuid": "order_123",
  "author": "BizKitHub",
  "debug": true
}'

Response

JSON payload

{
  "success": true,
  "downloadUrl": "https://storage.xhp.cz/...",
  "token": "abc123...",
  "blobPath": "pdf/2026-01/invoice_..._R4nd0mStr1ng.pdf",
  "size": 153042
}

All response codes

1 status code documented

Need an API key?

All BizKitHub API endpoints require authentication via API key.

Get API Key