ask_for_images

Gives a link where the person uploads pictures from their device for you — their logo, photos, a signature scan — when you cannot take the file from the chat yourself (you see an attached picture but have no file of it, or they have not sent it yet). Give them the link and say what to upload. When they say they are done, call ask_for_images again with upload_id: you get each image's link (with its size and file name) to put in the document — render_pdf, update_document. A program with the file (a shell, a code sandbox) can POST its bytes to the same link instead. The link works for 24 hours and takes up to 50 images — photos straight from a phone or a camera too (HEIC, up to 40 MB each; brought to print size, 4096 px on the long side).

Argument	Type	Description
note	string	What to upload, shown to the person on the page, e.g. "Your company logo (PNG with a transparent background is best)". Only for a new link.
upload_id	string	The upload_id of a link you gave: what the person has uploaded to it so far.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "note": {
      "type": "string",
      "description": "What to upload, shown to the person on the page, e.g. \"Your company logo (PNG with a transparent background is best)\". Only for a new link."
    },
    "upload_id": {
      "type": "string",
      "description": "The upload_id of a link you gave: what the person has uploaded to it so far."
    }
  },
  "additionalProperties": false
}

connect_account

Signs the person in to their ReflowPDF account (a free one is enough), when they want PDFs without the ReflowPDF mark, their plan's pages, or the documents you make kept in their account. Their client shows a Connect button; once they have signed in, every call of yours is their account's. Without it everything works too, as a guest: every page, with a small mark.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

get_document

Returns a document made with ReflowPDF (by you, or opened in the editor from your link) as it is now — the person may have edited it in the editor: its source HTML, template data and revision. Read it before changing it with update_document.

read-only

Argument	Type	Description
document_id*	string	The document_id (or the edit link) from render_pdf, render_template or open_in_editor.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "document_id"
  ],
  "properties": {
    "document_id": {
      "type": "string",
      "description": "The document_id (or the edit link) from render_pdf, render_template or open_in_editor."
    }
  },
  "additionalProperties": false
}

get_template

Returns a gallery template's source and its sample data, to fill with the person's values (render_template) or to adapt into your own template.

read-only

Argument	Type	Description
id*	string	The template's id, from list_templates.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "The template's id, from list_templates."
    }
  },
  "additionalProperties": false
}

import_pdf

Returns a link (valid 24 hours) that opens an existing PDF in the ReflowPDF editor's import, which rebuilds it as an editable document. A PDF exported from the ReflowPDF editor with «Keep the PDF editable» opens from its own source at once; any other — the PDFs these tools print too — is rebuilt by AI, which needs a free account and uses its AI pages (the editor shows the cost first). A document you made with these tools needs no import: give the person its edit link. Give the PDF the person attached in the chat (pdf, as your client passes attached files), a public https URL of it, or its bytes in base64 (small files). A PDF you cannot pass on: the person opens the editor (https://app.reflowpdf.com) and imports it there.

Argument	Type	Description
pdf	object	A PDF the person attached in the chat, as your client passes attached files to tools.
url	string	A public https address of the PDF.
name	string	The document's name. Default: the file's.
pdf_base64	string	The PDF's bytes, base64 (up to 20 MB).

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "pdf": {
      "type": "object",
      "required": [
        "download_url",
        "file_id"
      ],
      "properties": {
        "file_id": {
          "type": "string"
        },
        "file_name": {
          "type": "string"
        },
        "mime_type": {
          "type": "string"
        },
        "download_url": {
          "type": "string",
          "description": "A temporary https address of the file."
        }
      },
      "description": "A PDF the person attached in the chat, as your client passes attached files to tools.",
      "additionalProperties": true
    },
    "url": {
      "type": "string",
      "description": "A public https address of the PDF."
    },
    "name": {
      "type": "string",
      "description": "The document's name. Default: the file's."
    },
    "pdf_base64": {
      "type": "string",
      "description": "The PDF's bytes, base64 (up to 20 MB)."
    }
  },
  "additionalProperties": false
}

list_templates

Lists the gallery's ready documents — invoices, quotes, receipts, statements, reports, contracts, letters, CVs, certificates, tickets, labels, menus and more — each a template with sample data. Search by a word ("invoice", "contract") or a category.

read-only

Argument	Type	Description
query	string	Words to look for in the name, purpose or category.
category	string	Only this category.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Words to look for in the name, purpose or category."
    },
    "category": {
      "enum": [
        "Finance",
        "Sales",
        "Business",
        "HR & Legal",
        "Logistics",
        "Health",
        "Events",
        "Personal",
        "Marketing",
        "Showcase"
      ],
      "type": "string",
      "description": "Only this category."
    }
  },
  "additionalProperties": false
}

open_in_editor

Returns the edit link of a document in the ReflowPDF editor, where the person edits it on the page and downloads it: your HTML, or a template with its data (kept as template and data, both editable). Use when the person wants to change the document themselves; you can read their changes and change it too (get_document, update_document).

Argument	Type	Description
data	object	The values of the template, if it is one.
html	string	The HTML document (or your own template source, with data).
name	string	The document's name in the editor.
template_id	string	A gallery template's id, instead of html.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "data": {
      "type": "object",
      "description": "The values of the template, if it is one.",
      "additionalProperties": true
    },
    "html": {
      "type": "string",
      "description": "The HTML document (or your own template source, with data)."
    },
    "name": {
      "type": "string",
      "description": "The document's name in the editor."
    },
    "template_id": {
      "type": "string",
      "description": "A gallery template's id, instead of html."
    }
  },
  "additionalProperties": false
}

read_guide

The engine's guide: "overview" (the tools), "html" (paper, headers/footers, page numbers, tables of contents, footnotes, fonts, images, accessibility), "pages" (page kinds, breaks and keeping together, covers, numbering, bleed and crop marks), "design" (columns, drop caps, page decorations and watermarks, spacing, images and text wrap, typography), "charts" (the chart block), "codes" (QR codes and barcodes), "forms" (fillable fields), "templates" (the template language).

read-only

Argument	Type	Description
topic	string	Default: html.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "topic": {
      "enum": [
        "overview",
        "html",
        "pages",
        "design",
        "charts",
        "codes",
        "forms",
        "templates"
      ],
      "type": "string",
      "description": "Default: html."
    }
  },
  "additionalProperties": false
}

render_pdf

Lays out a whole HTML document (with its CSS) as paged print and returns a download link to the PDF, valid 24 hours, and the document's edit link in the ReflowPDF editor (give the person both). Use @page for paper and margins, margin boxes for headers, footers and page numbers; JavaScript does not run. Read read_guide topic "html" before the first document. To change the document later, use update_document with its document_id.

Argument	Type	Description
html*	string	The whole HTML document: <!doctype html>, <html lang>, a <title>, a <style> in <head> with @page. Self-contained; images and fonts by https URL, data: URI or an upload_image link.
preview	boolean	Pictures (PNG) of pages come with the answer, so you can check the layout, fonts and images before giving the links. Default: true.
filename	string	The PDF file name, e.g. "invoice-1042.pdf". Default: the document's <title>.
preview_pages	array	Which pages to see, 1-based; -1 is the last page. Default: page 1 and the last page (a page that spilled over shows there). Up to 4, e.g. [1, 2, -1].

Input schema (JSON)

{
  "type": "object",
  "required": [
    "html"
  ],
  "properties": {
    "html": {
      "type": "string",
      "description": "The whole HTML document: <!doctype html>, <html lang>, a <title>, a <style> in <head> with @page. Self-contained; images and fonts by https URL, data: URI or an upload_image link."
    },
    "preview": {
      "type": "boolean",
      "description": "Pictures (PNG) of pages come with the answer, so you can check the layout, fonts and images before giving the links. Default: true."
    },
    "filename": {
      "type": "string",
      "description": "The PDF file name, e.g. \"invoice-1042.pdf\". Default: the document's <title>."
    },
    "preview_pages": {
      "type": "array",
      "items": {
        "type": "integer"
      },
      "maxItems": 4,
      "description": "Which pages to see, 1-based; -1 is the last page. Default: page 1 and the last page (a page that spilled over shows there). Up to 4, e.g. [1, 2, -1]."
    }
  },
  "additionalProperties": false
}

render_template

Fills a template with JSON data and prints it to PDF (a download link, valid 24 hours, and the edit link in the editor, where its template and data stay editable — until the person edits it on the page, which makes it a plain HTML document: then change its html). Either a gallery template (template_id from list_templates; without data it prints its sample) or your own template source. Send data in the shape of the template's sample (get_template). The language: read_guide topic "templates".

Argument	Type	Description
data	object	The values the template reads, in the shape of its sample data.
preview	boolean	Pictures (PNG) of pages come with the answer, so you can check the layout, fonts and images before giving the links. Default: true.
filename	string	The PDF file name. Default: the template's name or the document's <title>.
template	string	Your own template source (HTML with {{ value }}, {% for %}, {% if %}), instead of template_id.
template_id	string	A gallery template's id, from list_templates.
preview_pages	array	Which pages to see, 1-based; -1 is the last page. Default: page 1 and the last page (a page that spilled over shows there). Up to 4, e.g. [1, 2, -1].

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "data": {
      "type": "object",
      "description": "The values the template reads, in the shape of its sample data.",
      "additionalProperties": true
    },
    "preview": {
      "type": "boolean",
      "description": "Pictures (PNG) of pages come with the answer, so you can check the layout, fonts and images before giving the links. Default: true."
    },
    "filename": {
      "type": "string",
      "description": "The PDF file name. Default: the template's name or the document's <title>."
    },
    "template": {
      "type": "string",
      "description": "Your own template source (HTML with {{ value }}, {% for %}, {% if %}), instead of template_id."
    },
    "template_id": {
      "type": "string",
      "description": "A gallery template's id, from list_templates."
    },
    "preview_pages": {
      "type": "array",
      "items": {
        "type": "integer"
      },
      "maxItems": 4,
      "description": "Which pages to see, 1-based; -1 is the last page. Default: page 1 and the last page (a page that spilled over shows there). Up to 4, e.g. [1, 2, -1]."
    }
  },
  "additionalProperties": false
}

update_document

Writes a new version of a document by its link — e.g. the person asks in the chat to remove something on page 2 — and prints it again: the PDF link, the same edit link (the editor open on it shows the change). Send the whole new html (and data, if it is a template), changed from what get_document returned, with base_revision: a document the person changed after you read it is refused, so read it again.

Argument	Type	Description
data	object	The template's new data. Alone, only for a template (kind "template"); with html, non-empty data makes the document a template. Omitted: the data stays.
html	string	The whole new source. Omitted: the source stays (e.g. new data only).
name	string	A new name.
preview	boolean	Pictures (PNG) of pages come with the answer, so you can check the layout, fonts and images before giving the links. Default: true.
filename	string	A new PDF file name, kept for its later prints. Default: the name it was printed with (render_pdf filename), else its <title>.
document_id*	string	The document_id (or the edit link).
base_revision*	integer	The revision you read (get_document, or the last result). Required: a document the person changed after it is refused, never overwritten.

upload_image

Keeps an image and returns its link, to use as <img src> or CSS url() in render_pdf, render_template, open_in_editor and update_document — so the document stays small when you read it back. Give one of: image — a picture the person attached in the chat, as your client passes attached files to tools; image_base64 — bytes you have yourself (one you made, a small file you can read: base64 is text you write, so tens of KB). PNG, JPEG, HEIC, GIF, WebP or AVIF; a photo over 10 MB or in HEIC is brought to print size (4096 px on the long side). A picture the person attached that you can see but have no file of: call ask_for_images, which gives them a link to upload it from their device. An image at a public https address needs no upload: use that address. An SVG goes into the HTML as it is. The image lasts 30 days after a document using it last changed.

Argument	Type	Description
image	object	A picture the person attached in the chat.
image_base64	string	The image's bytes, base64 (a data: URI is taken too).

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "image": {
      "type": "object",
      "required": [
        "download_url",
        "file_id"
      ],
      "properties": {
        "file_id": {
          "type": "string"
        },
        "file_name": {
          "type": "string"
        },
        "mime_type": {
          "type": "string"
        },
        "download_url": {
          "type": "string",
          "description": "A temporary https address of the file."
        }
      },
      "description": "A picture the person attached in the chat.",
      "additionalProperties": true
    },
    "image_base64": {
      "type": "string",
      "description": "The image's bytes, base64 (a data: URI is taken too)."
    }
  },
  "additionalProperties": false
}

ReflowPDF

Try it

ask_for_images

ReflowPDF

Try it

ask_for_images

Tools (12)