# Stolid
> Stolid PDF is an HTML-to-PDF API that returns the PDF and stable warning codes for detected font, asset, script and overflow issues. Use the report to choose a fix or a review; it does not verify every aspect of a document.
Stolid PDF is in free public preview, with access by request (hello@stolid.dev). The API is at https://api.stolid.dev/v1/pdf and takes `Authorization: Bearer `. Agents can use the HTTP API today. The hosted MCP server, page images, spending caps per key and untrusted-content labels are coming soon. Paid plans and AWS Marketplace purchasing are planned.
Use sample data during the public preview; keep real customer details, personal data and secrets out of requests. Attach every file a page needs: remote file loading is off. One call renders one document of up to 20 pages within 30 seconds, in a request of up to 6 MB. There is no uptime commitment yet. Warnings describe detected issues; an empty warnings list does not establish that the PDF is visually correct.
Every page below is also served as Markdown, and the links here are those Markdown versions.
## API contract
- [OpenAPI description](https://stolid.dev/openapi.json): the complete API description in OpenAPI 3.1, for tools and code generators.
## Product
- [Home](https://stolid.dev/index.md): Stolid PDF renders HTML to PDF and returns stable warning codes for detected font, asset and layout issues. Free public preview for developers and AI agents.
- [Stolid PDF](https://stolid.dev/pdf/index.md): Convert HTML to PDF over HTTP and get stable warning codes for detected rendering issues. Stolid PDF is free in public preview, with access by request.
- [Pricing](https://stolid.dev/pricing/index.md): Stolid PDF is free in public preview: 500 live and 100 test calls a month, no card. See the planned per-call pricing for after the preview.
- [Data handling](https://stolid.dev/data/index.md): How Stolid handles the HTML, files, PDFs and render reports you send: where they are processed, how long they are kept, and what to send during the public preview.
- [Request access](https://stolid.dev/access/index.md): Request a free Stolid PDF preview key: 500 live and 100 test calls a month, no card. Email us, accept the Preview Terms by reply, then get your keys.
## Docs
- [Overview](https://stolid.dev/docs/index.md): Use the Stolid HTML to PDF API with curl, Python or Node.js. Find authentication, request examples, render warnings, limits and the OpenAPI schema.
- [Quickstart](https://stolid.dev/docs/quickstart/index.md): Render your first PDF with the Stolid HTML to PDF API and read its render report, using curl, then Python or Node.js.
- [Files and fonts](https://stolid.dev/docs/files-and-fonts/index.md): Send your CSS, images and fonts with a Stolid PDF request using assets, and use the bundled fonts or your own brand font.
- [Page options](https://stolid.dev/docs/page-options/index.md): Control page size, margins, scale, headers, footers and page breaks in Stolid PDF with the options object, plus tips for real documents.
- [API reference](https://stolid.dev/docs/api/index.md): HTTP endpoints, status codes, and common request and response fields. See the OpenAPI file for complete schemas.
- [Warning codes](https://stolid.dev/docs/warning-codes/index.md): Every Stolid PDF warning code, what it means and what to do about it. Stable codes for detected font, asset, script and overflow issues.
- [Limits, errors and retries](https://stolid.dev/docs/limits/index.md): The limits of a Stolid PDF call, every error code and what to do about it, how to retry safely with an Idempotency-Key, and how usage is counted.
- [Python and Node clients](https://stolid.dev/docs/clients/index.md): The Stolid PDF clients for Python (stolid-client) and Node.js (@stolidhq/client): install from the package file, render a PDF, read the warnings, send files and retry safely.
- [AI agents over HTTP](https://stolid.dev/docs/ai-agents/index.md): Let an AI agent generate a PDF from HTML with the Stolid API, read stable warning codes, fix detected issues and retry within a limit you set. Works over HTTP today.
- [MCP server](https://stolid.dev/docs/mcp/index.md): The hosted Stolid PDF MCP server is coming soon. Today, agents can render PDFs over the HTTP API and read stable warning codes.
## Legal
- [Preview Terms and Acceptable Use Policy](https://stolid.dev/legal/terms/index.md): The terms for the Stolid PDF public preview: who can use it, sample data only, the Acceptable Use Policy, your content, and how to report abuse or copyright infringement.
- [Privacy Policy](https://stolid.dev/legal/privacy/index.md): What personal information Stolid collects through the website, access requests, preview accounts and the API, why, who handles it, and how long it is kept.
## Optional
- [Sitemap](https://stolid.dev/sitemap.xml): every HTML page of the site.