API Reference

Base URL: https://api.pagekiln.dev/v1 — bearer-token auth on every route except GET /health.

A fully generated reference (from our OpenAPI 3.1 contract) is coming. The surface today:

Endpoint	Methods	Purpose
/health	GET	Service health
/render	POST	Render one PDF (inline or URL)
/batches	GET, POST	Create/list batch jobs
/batches/{batch_id}	GET	Batch status + item results
/templates	GET, POST	Create/list templates
/templates/{template_id}	GET, DELETE	Template detail/delete
/templates/{template_id}/versions	GET, POST	Template versions
/fonts	GET, POST	Custom fonts
/fonts/{font_id}	DELETE	Remove font
/keys	GET, POST	API keys
/keys/{key_id}	DELETE	Revoke key
/webhooks	GET, POST	Webhooks
/webhooks/{webhook_id}	DELETE	Revoke webhook
/webhooks/{webhook_id}/deliveries	GET	Delivery log
/usage	GET	Usage summary

Errors share one shape: {"error": {"code", "message", "request_id", "details?"}}.