Dynamic Document API

Generate a standalone, validated e-invoice XML file from invoice data — e.g. an XRechnung for a German public-sector buyer, or an EN 16931 invoice for a Peppol network. To embed the invoice in a PDF instead, use `render_pdf_from_template` with `einvoice`. Returns a signed download URL for the XML (valid for `expires_in`, default 1 h) and the validator's verdict in `conformance.einvoice.status` (passed | failed | unavailable). If the data breaks a rule of the profile, the call fails and lists every problem with its field path. Needs the Growth plan or higher; on other plans the call fails with 402 `plan_feature_unavailable`. Test mode unless you pass `test: false`: test renders are free, carry a TEST note in the XML (MINIMUM has no field for it) and are limited per minute by plan; final ones are billed (1 render per XML), failed ones are free. Limited to 60 tool calls a minute per connection, shared by all tools.

create_einvoice

Fetch one render of the connected workspace by id: its status, files with freshly signed download URLs, `billed_renders` and the conformance report. Use it when a render tool returned `queued` or `processing` (most renders reach `succeeded` or `failed` within seconds), or when a download link has expired. Not needed after a render tool already returned `succeeded` with its files. New URLs last the render's `expires_in` again, until the plan's file retention ends; after that the render is `expired` and its files have no URL. Not billed. Limited to 60 tool calls a minute per connection, shared by all tools.

get_render

Get the `data` a template expects before rendering it: its JSON Schema, every field as a dotted path with type and required flag, an image template's dynamic properties, an example payload and `einvoice_default` (the template's default ZUGFeRD / Factur-X e-invoice, or null). One call per template is enough; the id comes from `list_templates` or from the user. `fields` and `example_data` show the shape of `data`, and `render_pdf_from_template` and `render_image_from_template` reject data that breaks the schema. `render_pdf_from_html` and `render_pdf_from_markdown` take no template and need no schema. When `einvoice_default` is set, every PDF render embeds that e-invoice, so `data` must also hold the invoice object at its `invoice_path` (on Free and Starter it is skipped with the warning `einvoice_skipped_plan`); `render_pdf_from_template` can replace it or turn it off. Not billed. Limited to 60 tool calls a minute per connection, shared by all tools.

get_template_schema

List the published templates of the connected workspace: id, name, type and live version. Use it to find the `template_id` for a document the user describes; skip it when you already have the id. PDF templates (`pdf_code`, `pdf_markdown`) go to `render_pdf_from_template`, image templates (`image_canvas`) to `render_image_from_template`; `get_template_schema` returns the data a template expects. Returns 50 templates per page unless `limit` says otherwise; pass `next_cursor` as `cursor` while `has_more`. Not billed. Limited to 60 tool calls a minute per connection, shared by all tools.

list_templates

Merge 2-200 existing PDFs into one PDF, in the order given, with a bookmark per source unless `bookmarks` is `none`. Use it to combine documents (e.g. a cover letter and an invoice from earlier renders) or PDFs at public URLs. It renders nothing itself, and the sources stay unchanged. Waits up to 25 s, then returns the files with signed download URLs valid for `expires_in` (default 1 h). A slower render comes back `queued` or `processing`: `get_render` collects it, and re-signs expired links. Test mode unless you pass `test: false`: test renders are free, carry a TEST watermark and are limited per minute by plan; final ones are billed (1 render per merge, whatever the page count), failed ones are free. Limited to 60 tool calls a minute per connection, shared by all tools.

merge_pdfs

Render a PDF from HTML and CSS you write, in headless Chromium. Use it when no saved template fits and the layout matters: letters, styled tables, one-off documents. For a saved template use `render_pdf_from_template`; for a text report without layout work `render_pdf_from_markdown` is shorter. With `data`, the HTML is a Jinja template (`{{ name }}`, `{% for row in rows %}`). Remote images and fonts must be public URLs; load web fonts with <link> tags in `head`. Waits up to 25 s, then returns the files with signed download URLs valid for `expires_in` (default 1 h). A slower render comes back `queued` or `processing`: `get_render` collects it, and re-signs expired links. Test mode unless you pass `test: false`: test renders are free, carry a TEST watermark and are limited per minute by plan; final ones are billed (1 render per 50 pages), failed ones are free. Limited to 60 tool calls a minute per connection, shared by all tools.

render_pdf_from_html

Render a PDF from Markdown with a built-in theme: the quickest way to turn a report, summary or notes you have written into a clean document, with no layout work. Supports tables, task lists, footnotes and strikethrough; raw HTML is not rendered. For a designed layout use `render_pdf_from_html`, for a saved template `render_pdf_from_template`. Waits up to 25 s, then returns the files with signed download URLs valid for `expires_in` (default 1 h). A slower render comes back `queued` or `processing`: `get_render` collects it, and re-signs expired links. Test mode unless you pass `test: false`: test renders are free, carry a TEST watermark and are limited per minute by plan; final ones are billed (1 render per 50 pages), failed ones are free. Limited to 60 tool calls a minute per connection, shared by all tools.

render_pdf_from_markdown

Render a PDF from a saved template of the workspace plus JSON `data`. Use it when a template exists for the document (invoices, quotes, certificates, recurring reports); otherwise write the layout with `render_pdf_from_html` or turn text into a PDF with `render_pdf_from_markdown`, and use `render_image_from_template` for images. `template_id` comes from `list_templates` and the shape of `data` from `get_template_schema`; data that breaks the schema fails with each wrong field's path. Waits up to 25 s, then returns the files with signed download URLs valid for `expires_in` (default 1 h). A slower render comes back `queued` or `processing`: `get_render` collects it, and re-signs expired links. Test mode unless you pass `test: false`: test renders are free, carry a TEST watermark and are limited per minute by plan; final ones are billed (1 render per 50 pages), failed ones are free. Pass `einvoice` for a hybrid e-invoice PDF (Factur-X / ZUGFeRD / XRechnung) that accounting software can read. A template with `einvoice_default` (from `get_template_schema`) embeds a ZUGFeRD / Factur-X e-invoice in every PDF render, a hybrid PDF/A-3b, read from `data` at its `invoice_path` (missing: 400 validation_error at /data). `einvoice` replaces that default, `einvoice: null` turns it off for a plain PDF. On plans without e-invoicing (Free, Starter) the PDF is rendered without it and carries the warning `einvoice_skipped_plan`; e-invoicing needs the Growth plan or higher. Limited to 60 tool calls a minute per connection, shared by all tools.

render_pdf_from_template

Render a PNG, JPEG or WebP image from a saved image template (`image_canvas`) plus `data`: social and Open Graph images, banners, badges. Image templates are listed by `list_templates` (`type: image_canvas`); their dynamic properties, from `get_template_schema`, go in `data` as dotted keys such as `title.text` or `hero.src` (an image URL). A PDF comes from `render_pdf_from_template`. Waits up to 25 s, then returns the files with signed download URLs valid for `expires_in` (default 1 h). A slower render comes back `queued` or `processing`: `get_render` collects it, and re-signs expired links. Test mode unless you pass `test: false`: test renders are free, carry a TEST watermark and are limited per minute by plan; final ones are billed (1 render per image), failed ones are free. Limited to 60 tool calls a minute per connection, shared by all tools.

render_image_from_template