canonical: https://jentic.com/apis/docamatic.com/docamatic # Docamatic API The Docamatic API generates PDFs and images from URLs, raw HTML, or reusable templates, and manipulates existing files. It writes text, images, QR codes, and barcodes onto a PDF, merges several PDFs into one, and password-protects a document. Account operations list stored documents and templates and report usage for the current billing period. ## For AI agents Generate PDFs and images from HTML or templates, capture screenshots, write to and merge PDFs, encrypt documents, and check account usage with Docamatic. ## Scope Does not handle OCR, e-signatures, or data extraction. Use for generating and manipulating PDFs, images, and screenshots only. ## Capabilities - Generate a PDF from a URL or raw HTML - Generate a PDF or image from a reusable template - Capture a screenshot or image of a URL or HTML page - Write text, images, QR codes, and barcodes onto an existing PDF - Merge multiple PDFs into one document and password-protect a PDF - List stored documents and templates and check account credits ## Use cases ### Agent-Generated Documents An AI agent connected through Jentic renders an invoice or report by posting HTML or a template to Docamatic and receiving a finished PDF. The API returns the generated file, and Jentic injects the bearer token at call time so the agent never holds the key. Example prompt: Generate a PDF from an HTML invoice template with customer values filled in and return the file URL ### Screenshots and Images Teams that need web-page snapshots or generated images capture them on demand. The Docamatic API renders a screenshot or image from a URL or HTML, so an agent can produce a visual for a report or a thumbnail for a listing. Example prompt: Capture a full-page screenshot of a URL and return the image ### PDF Assembly and Protection Document workflows often need several files combined, annotated, and secured. The Docamatic API writes text, images, QR codes, and barcodes onto a PDF, merges multiple PDFs into one, and password-protects the result. Example prompt: Merge three PDFs into one document, add a QR code to the first page, and encrypt the file with a password ## Key endpoints | Method | Path | Description | | --- | --- | --- | | POST | `/pdf` | Generate a PDF from URL or HTML | | POST | `/template` | Generate a PDF or image from a template | | POST | `/image` | Generate an image or screenshot from URL or HTML | | POST | `/write` | Write text, images, QR codes, and barcodes to a PDF | | POST | `/merge` | Merge multiple PDFs into one document | | POST | `/encrypt` | Password-protect an existing PDF | | GET | `/credits` | Get the usage summary for the current period | | GET | `/templates` | List templates available to the user | ## Key resources - **Documents** — Generate PDFs and images, write to, merge, encrypt, list, and delete documents - **Templates** — Generate from and list reusable PDF and image templates - **Account** — Report account credits and the authenticated user profile ## AI readiness This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use. - **Score:** 70 / 100 - **Maturity:** AI-Aware - **Dimensions:** - Foundational Compliance: 93 / 100 - Developer Experience & Jentic Compatibility: 67 / 100 - AI-Readiness & Agent Experience: 56 / 100 - Agent Usability: 94 / 100 - Security: 60 / 100 - AI Discoverability: 68 / 100 - **View full report:** https://jentic.com/apis/docamatic.com/docamatic/scorecard - **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/ - **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview ### Score it yourself Every API in the directory is allowlisted, so you can re-score it with no key required. - **Score your own API:** https://jentic.com/scorecard.md - **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md ```sh npx @jentic/api-scorecard-cli score ``` ## Why Jentic - **Setup:** Wiring Docamatic by hand means managing its bearer-token API key, posting HTML or template payloads, and polling for generated files yourself. Through Jentic you install once, import Docamatic from the API Directory, store the token once, and your agent calls it. - **Permission scoping:** Docamatic takes its inputs in the request body rather than the URL path, so rules bound which operations your agent may call. Limit the agent to the operations it needs, such as generating PDFs and images, so destructive operations like deleting a stored document are not included unless you add them. - **Credential handling:** Your Docamatic token is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context. - **Discovery method:** Agents search Jentic by intent such as 'generate a PDF from HTML' or 'take a screenshot', and Jentic returns the matching Docamatic operation with its input schema so the agent calls the right endpoint directly. ## Related APIs - **PDFMonkey** — PDFMonkey generates PDFs from templates, overlapping with Docamatic's template rendering. - **CraftMyPDF** — CraftMyPDF builds PDFs from a drag-and-drop template editor, similar to Docamatic's template generation. - **Urlbox** — Urlbox specializes in high-fidelity website screenshots you can feed into a Docamatic document. ## FAQ ### What authentication does the Docamatic API use? The Docamatic API authenticates with a bearer token, which is your Docamatic API key sent in the Authorization header per its OpenAPI spec. Through Jentic the token is stored encrypted by your own Jentic One instance and injected at execution time, so it never enters the agent's prompt or logs. ### Can I generate PDFs and images with the Docamatic API? Yes. The API generates a PDF or image from a URL, raw HTML, or a reusable template, and captures screenshots. It also writes text, images, QR codes, and barcodes onto an existing PDF, merges PDFs, and password-protects a document. ### Is there a Docamatic MCP server? You don't need an MCP server to give your agent the Docamatic API. Jentic connects it directly from the API Directory: import it, store your token once, and your agent calls the generation and PDF operations. Operations load on demand, so your agent's context stays lean instead of holding another server's tool definitions. ### Can I limit what my agent is allowed to do with the Docamatic API? Yes. Write a rule that allows only the generate operations, such as creating a PDF or image, so the agent can produce documents but cannot delete stored files or merge and encrypt them. Every call the agent makes is logged. ### What are the rate limits for the Docamatic API? The OpenAPI spec does not specify rate limits; usage is drawn from the account credits reported by the credits endpoint. Check the Docamatic documentation at https://docamatic.com for current limits and credit pricing before running a large batch. ### How do I generate a PDF with the Docamatic API through Jentic? Search Jentic for an intent like 'generate a PDF from HTML', add the Docamatic API from the directory, and store your token once. Your agent then posts the HTML or template and receives the finished file. To run it on your own infrastructure, install Jentic One from its GitHub repo.