Skills document-generation-api

Name: document-generation-api
Author: iterationlayer

Generate PDF, DOCX, EPUB, and PPTX documents from structured content blocks.

install

source · Clone the upstream repo

git clone https://github.com/iterationlayer/skills

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/iterationlayer/skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/document-generation-api" ~/.claude/skills/iterationlayer-skills-document-generation-api && rm -rf "$T"

manifest: skills/document-generation-api/SKILL.md

source content

Document Generation API

Generate PDF, DOCX, EPUB, and PPTX documents from structured content blocks.

Cost: 2 credits per request

Prerequisites

You need an Iteration Layer API key. Get one at platform.iterationlayer.com — free trial credits included, no credit card required.

For full integration guidance (SDKs, auth, MCP, error handling), see the Iteration Layer Integration Guide.

API Reference

Generate PDF, DOCX, EPUB, and PPTX documents from a single API call. Send a structured document definition with metadata, page settings, styles, and content blocks, and receive the rendered document as base64-encoded JSON in the response.

Key Features

Multi-Format Output -- Generate PDF, DOCX, EPUB, and PPTX from one unified document structure.
Rich Content Blocks -- Paragraphs with rich text runs, headlines (h1-h6), images, tables, grids, lists, QR codes, barcodes, and more.
12-Column Grid Layout -- Arrange content blocks side by side using a flexible 12-column grid system.
Optional Styles with Sensible Defaults -- Styles and page settings are optional. Defaults use PlusJakartaSans for body text, Outfit for headings, black text, sky-500 links, A4 pages with 72pt margins.
Font Weight Support -- Full range from thin to black, not just bold/not-bold. PDF and EPUB render all weights; DOCX and PPTX map semibold and above to bold.
Two-Layer Style System -- Define document-wide default styles, then override per block for full control.
Headers and Footers -- Repeating headers and footers with the same block types as body content, plus page numbers.
Bundled Google Fonts + Custom Fonts -- The top Google Fonts are bundled and available by default. Upload additional font files (base64-encoded) with weight and style metadata for full typographic control.
Page Size Presets -- Built-in presets (A0-A6, B0-B6, Letter, Legal, Tabloid, Executive, Statement) plus custom dimensions.
Table of Contents -- Auto-generated from headlines with configurable levels and dot leaders.
PPTX Slide Support -- Each page-break creates a new slide in PowerPoint output.

Overview

The Document Generation API renders structured documents from a JSON definition. You send a format, document metadata, and an ordered list of content blocks, and receive the rendered document as base64-encoded JSON. Page settings and styles are optional -- sensible defaults are applied automatically (A4 with 72pt margins, PlusJakartaSans body, Outfit headings, black text, sky-500 links).

Endpoint:

POST /document-generation/v1/generate

Supported output formats: PDF, DOCX, EPUB, PPTX

Request Format

curl -X POST \
  https://api.iterationlayer.com/document-generation/v1/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "format": "pdf",
    "document": {
      "metadata": {
        "title": "Quarterly Report",
        "author": "Acme Corp",
        "language": "en"
      },
      "page": {
        "size": {
          "preset": "A4"
        },
        "margins": {
          "top_in_pt": 72.0,
          "right_in_pt": 72.0,
          "bottom_in_pt": 72.0,
          "left_in_pt": 72.0
        }
      },
      "styles": {
        "text": {
          "font_family": "Helvetica",
          "font_size_in_pt": 12.0,
          "line_height": 1.5,
          "color": "#000000"
        },
        "headline": {
          "font_family": "Helvetica",
          "font_size_in_pt": 24.0,
          "color": "#111111",
          "spacing_before_in_pt": 12.0,
          "spacing_after_in_pt": 6.0,
          "font_weight": "bold"
        },
        "link": {
          "color": "#0066CC",
          "is_underlined": true
        },
        "list": {
          "text_style": {
            "font_family": "Helvetica",
            "font_size_in_pt": 12.0,
            "line_height": 1.5,
            "color": "#000000"
          },
          "marker_color": "#000000",
          "marker_gap_in_pt": 8.0
        },
        "table": {
          "header": {
            "background_color": "#333333",
            "text_color": "#FFFFFF",
            "font_size_in_pt": 12.0,
            "font_weight": "bold"
          },
          "body": {
            "background_color": "#FFFFFF",
            "text_color": "#000000",
            "font_size_in_pt": 11.0
          },
          "border": {
            "outer": {
              "top": {
                "color": "#CCCCCC",
                "width_in_pt": 1.0
              },
              "right": {
                "color": "#CCCCCC",
                "width_in_pt": 1.0
              },
              "bottom": {
                "color": "#CCCCCC",
                "width_in_pt": 1.0
              },
              "left": {
                "color": "#CCCCCC",
                "width_in_pt": 1.0
              }
            },
            "inner": {
              "horizontal": {
                "color": "#EEEEEE",
                "width_in_pt": 0.5
              },
              "vertical": {
                "color": "#EEEEEE",
                "width_in_pt": 0.5
              }
            }
          }
        },
        "grid": {
          "background_color": "#FFFFFF",
          "border_color": "#CCCCCC",
          "border_width_in_pt": 0.0,
          "gap_in_pt": 12.0
        },
        "separator": {
          "color": "#CCCCCC",
          "thickness_in_pt": 1.0,
          "spacing_before_in_pt": 12.0,
          "spacing_after_in_pt": 12.0
        },
        "image": {
          "border_color": "#000000",
          "border_width_in_pt": 0.0
        }
      },
      "content": [
        {
          "type": "headline",
          "level": "h1",
          "text": "Quarterly Report"
        },
        {
          "type": "paragraph",
          "runs": [
            {
              "text": "This is "
            },
            {
              "text": "bold text",
              "font_weight": "bold"
            },
            {
              "text": " in a paragraph."
            }
          ]
        }
      ]
    }
  }'

import { IterationLayer } from "iterationlayer";
const client = new IterationLayer({
  apiKey: "YOUR_API_KEY",
});

const result = await client.generateDocument({
  format: "pdf",
  document: {
    metadata: {
      title: "Quarterly Report",
      author: "Acme Corp",
      language: "en",
    },
    page: {
      size: {
        preset: "A4",
      },
      margins: {
        top_in_pt: 72.0,
        right_in_pt: 72.0,
        bottom_in_pt: 72.0,
        left_in_pt: 72.0,
      },
    },
    styles: {
      text: {
        font_family: "Helvetica",
        font_size_in_pt: 12.0,
        line_height: 1.5,
        color: "#000000",
      },
      headline: {
        font_family: "Helvetica",
        font_size_in_pt: 24.0,
        color: "#111111",
        spacing_before_in_pt: 12.0,
        spacing_after_in_pt: 6.0,
        font_weight: "bold",
      },
      link: {
        color: "#0066CC",
        is_underlined: true,
      },
      list: {
        text_style: {
          font_family: "Helvetica",
          font_size_in_pt: 12.0,
          line_height: 1.5,
          color: "#000000",
        },
        marker_color: "#000000",
        marker_gap_in_pt: 8.0,
      },
      table: {
        header: {
          background_color: "#333333",
          text_color: "#FFFFFF",
          font_size_in_pt: 12.0,
          font_weight: "bold",
        },
        body: {
          background_color: "#FFFFFF",
          text_color: "#000000",
          font_size_in_pt: 11.0,
        },
        border: {
          outer: {
            top: {
              color: "#CCCCCC",
              width_in_pt: 1.0,
            },
            right: {
              color: "#CCCCCC",
              width_in_pt: 1.0,
            },
            bottom: {
              color: "#CCCCCC",
              width_in_pt: 1.0,
            },
            left: {
              color: "#CCCCCC",
              width_in_pt: 1.0,
            },
          },
          inner: {
            horizontal: {
              color: "#EEEEEE",
              width_in_pt: 0.5,
            },
            vertical: {
              color: "#EEEEEE",
              width_in_pt: 0.5,
            },
          },
        },
      },
      grid: {
        background_color: "#FFFFFF",
        border_color: "#CCCCCC",
        border_width_in_pt: 0.0,
        gap_in_pt: 12.0,
      },
      separator: {
        color: "#CCCCCC",
        thickness_in_pt: 1.0,
        spacing_before_in_pt: 12.0,
        spacing_after_in_pt: 12.0,
      },
      image: {
        border_color: "#000000",
        border_width_in_pt: 0.0,
      },
    },
    content: [
      {
        type: "headline",
        level: "h1",
        text: "Quarterly Report",
      },
      {
        type: "paragraph",
        runs: [
          {
            text: "This is ",
          },
          {
            text: "bold text",
            font_weight: "bold",
          },
          {
            text: " in a paragraph.",
          },
        ],
      },
    ],
  },
});

from iterationlayer import IterationLayer
client = IterationLayer(api_key="YOUR_API_KEY")

result = client.generate_document(
    format="pdf",
    document={
        "metadata": {
            "title": "Quarterly Report",
            "author": "Acme Corp",
            "language": "en",
        },
        "page": {
            "size": {
                "preset": "A4",
            },
            "margins": {
                "top_in_pt": 72.0,
                "right_in_pt": 72.0,
                "bottom_in_pt": 72.0,
                "left_in_pt": 72.0,
            },
        },
        "styles": {
            "text": {
                "font_family": "Helvetica",
                "font_size_in_pt": 12.0,
                "line_height": 1.5,
                "color": "#000000",
            },
            "headline": {
                "font_family": "Helvetica",
                "font_size_in_pt": 24.0,
                "color": "#111111",
                "spacing_before_in_pt": 12.0,
                "spacing_after_in_pt": 6.0,
                "font_weight": "bold",
            },
            "link": {
                "color": "#0066CC",
                "is_underlined": True,
            },
            "list": {
                "text_style": {
                    "font_family": "Helvetica",
                    "font_size_in_pt": 12.0,
                    "line_height": 1.5,
                    "color": "#000000",
                },
                "marker_color": "#000000",
                "marker_gap_in_pt": 8.0,
            },
            "table": {
                "header": {
                    "background_color": "#333333",
                    "text_color": "#FFFFFF",
                    "font_size_in_pt": 12.0,
                    "font_weight": "bold",
                },
                "body": {
                    "background_color": "#FFFFFF",
                    "text_color": "#000000",
                    "font_size_in_pt": 11.0,
                },
                "border": {
                    "outer": {
                        "top": {
                            "color": "#CCCCCC",
                            "width_in_pt": 1.0,
                        },
                        "right": {
                            "color": "#CCCCCC",
                            "width_in_pt": 1.0,
                        },
                        "bottom": {
                            "color": "#CCCCCC",
                            "width_in_pt": 1.0,
                        },
                        "left": {
                            "color": "#CCCCCC",
                            "width_in_pt": 1.0,
                        },
                    },
                    "inner": {
                        "horizontal": {
                            "color": "#EEEEEE",
                            "width_in_pt": 0.5,
                        },
                        "vertical": {
                            "color": "#EEEEEE",
                            "width_in_pt": 0.5,
                        },
                    },
                },
            },
            "grid": {
                "background_color": "#FFFFFF",
                "border_color": "#CCCCCC",
                "border_width_in_pt": 0.0,
                "gap_in_pt": 12.0,
            },
            "separator": {
                "color": "#CCCCCC",
                "thickness_in_pt": 1.0,
                "spacing_before_in_pt": 12.0,
                "spacing_after_in_pt": 12.0,
            },
            "image": {
                "border_color": "#000000",
                "border_width_in_pt": 0.0,
            },
        },
        "content": [
            {
                "type": "headline",
                "level": "h1",
                "text": "Quarterly Report",
            },
            {
                "type": "paragraph",
                "runs": [
                    {
                        "text": "This is ",
                    },
                    {
                        "text": "bold text",
                        "font_weight": "bold",
                    },
                    {
                        "text": " in a paragraph.",
                    },
                ],
            },
        ],
    },
)

import il "github.com/iterationlayer/sdk-go"
client := il.NewClient("YOUR_API_KEY")

result, err := client.GenerateDocument(
	il.GenerateDocumentRequest{
		Format: "pdf",
		Document: il.DocumentDefinition{
			Metadata: il.DocumentMetadata{
				Title:    "Quarterly Report",
				Author:   "Acme Corp",
				Language: "en",
			},
			Page: il.DocumentPage{
				Size: il.DocPageSize{
				Preset: "A4",
			},
				Margins: il.DocMargins{
					TopInPt:    72,
					RightInPt:  72,
					BottomInPt: 72,
					LeftInPt:   72,
				},
			},
			Styles: il.DocumentStyles{
				Text: il.TextStyle{
					FontFamily:  "Helvetica",
					FontSizeInPt: 12,
					Color:       "#000000",
					LineHeight:  1.5,
				},
				Headline: il.HeadlineStyle{
					FontFamily:        "Helvetica",
					FontSizeInPt:      24,
					Color:             "#111111",
					SpacingBeforeInPt: 12,
					SpacingAfterInPt:  6,
					FontWeight:        "bold",
				},
			},
			Content: []il.ContentBlock{
				il.NewHeadlineBlock("h1", "Quarterly Report"),
				il.ParagraphBlock{
					Type: "paragraph",
					Runs: []il.TextRun{
						{
							Text: "This is ",
						},
						{
							Text:       "bold text",
							FontWeight: "bold",
						},
						{
							Text: " in a paragraph.",
						},
					},
				},
			},
		},
	},
)

{
  "success": true,
  "data": {
    "buffer": "JVBERi0xLjcKMSAwIG9iago8...",
    "mime_type": "application/pdf"
  }
}

Document Structure

The top-level request has the following fields:

Field Type Required Description

format

string

Yes

Output format:

pdf

docx

epub

, or

pptx

document

object

Yes

The full document definition (see below)

webhook_url

string

HTTPS URL to receive results asynchronously. If provided, returns 201 immediately. See Webhooks.

Async Mode

Add a

webhook_url

parameter to process the request in the background. The API returns

201 Accepted

immediately and delivers the result to your webhook URL when processing completes. See Webhooks for payload format and retry behavior.

The

document

object contains:

Field	Type	Required	Description
`metadata`	object	Yes	Document metadata (title, author, language)
`page`	object	No	Page size and margins. Defaults to A4 with 72pt margins
`fonts`	array	No	Custom font definitions (base64-encoded font files)
`styles`	object	No	Document-wide default styles. Defaults to PlusJakartaSans body, Outfit headings, black text, sky-500 links
`header`	array	No	Content blocks rendered at the top of every page
`footer`	array	No	Content blocks rendered at the bottom of every page
`header_distance_from_edge_in_pt`	float	No	Distance from the page edge to the header
`footer_distance_from_edge_in_pt`	float	No	Distance from the page edge to the footer
`content`	array	Yes	Ordered list of content blocks

Metadata

Field	Type	Required	Description
`title`	string	Yes	Document title (min 1 character)
`author`	string	No	Document author
`language`	string	No	Language code (min 2 characters, e.g., `"en"` )

{
  "metadata": {
    "title": "Annual Report 2025",
    "author": "Acme Corp",
    "language": "en"
  }
}

Page Settings

The

page

object controls page dimensions, margins, and background color.

Field	Type	Required	Description
`size`	object	Yes	Page size (preset or custom dimensions)
`margins`	object	Yes	Page margins
`background_color`	string	No	Hex color for the page background (e.g., `#FFFFFF` )

Page size -- use a preset or provide custom dimensions:

Field Type Required Description

preset

string

One of:

A0

A6

B0

B6

Letter

Legal

Tabloid

Executive

Statement

width_in_pt

float

Custom width in points (>= 1)

height_in_pt

float

Custom height in points (>= 1)

Use either

preset

or both

width_in_pt

and

height_in_pt

Margins:

Field	Type	Required	Description
`top_in_pt`	float	Yes	Top margin in points (>= 0)
`right_in_pt`	float	Yes	Right margin in points (>= 0)
`bottom_in_pt`	float	Yes	Bottom margin in points (>= 0)
`left_in_pt`	float	Yes	Left margin in points (>= 0)

{
  "page": {
    "size": {
      "preset": "A4"
    },
    "margins": {
      "top_in_pt": 72.0,
      "right_in_pt": 72.0,
      "bottom_in_pt": 72.0,
      "left_in_pt": 72.0
    },
    "background_color": "#FFFFFF"
  }
}

Custom Fonts

The top Google Fonts are bundled and available by default. Documents can reference any bundled font by name without providing font definitions. If a font name isn't found, it falls back to Inter Regular.

Bundled fonts:

AlfaSlabOne
AnekTelugu
Anton
Archivo
ArchivoBlack
Arimo
Assistant
Barlow
BarlowCondensed
BebasNeue
Bitter
BricolageGrotesque
Bungee
Cabin
Cairo
Caveat
ChangaOne
CommitMono
CormorantGaramond
CrimsonText
DancingScript
DMSans
Dosis
EBGaramond
Exo2
Figtree
FiraSans
FjallaOne
GravitasOne
Heebo
Hind
HindSiliguri
IBMPlexSans
Inconsolata
Inter
InterTight
JosefinSans
Jost
Kanit
Karla
Lato
Lexend
LibreBaskerville
LibreFranklin
Lobster
Lora
Manrope
Merriweather
Montserrat
MPLUSRounded1c
Mukta
Mulish
NanumGothic
NotoSans
NotoSansArabic
NotoSansJP
NotoSansKR
NotoSansSC
NotoSansTC
NotoSansTelugu
NotoSerif
NotoSerifJP
Nunito
NunitoSans
OpenSans
Oswald
Outfit
Overpass
Oxygen
Pacifico
PlayfairDisplay
PlusJakartaSans
Poppins
Prompt
PTSans
PTSerif
PublicSans
Quicksand
Raleway
Ramabhadra
RedHatDisplay
Roboto
RobotoCondensed
RobotoFlex
RobotoMono
RobotoSlab
Rubik
Saira
SchibstedGrotesk
ShareTech
Slabo27px
SmoochSans
Sora
SourceCodePro
SourceSans3
SpaceGrotesk
TitilliumWeb
Ubuntu
WorkSans

To use additional fonts beyond the bundled set, upload them as base64-encoded font files. Each font definition requires a name, weight, style, and the font file data.

Field	Type	Required	Description
`name`	string	Yes	Font family name (min 1 character)
`weight`	string	Yes	One of: `thin` , `extralight` , `light` , `regular` , `medium` , `semibold` , `bold` , `extrabold` , `black`
`style`	string	Yes	One of: `normal` , `italic`
`buffer`	string	Yes	Base64-encoded font file (TTF, OTF, WOFF, or WOFF2)

{
  "fonts": [
    {
      "name": "CustomFont",
      "weight": "regular",
      "style": "normal",
      "buffer": "<base64-encoded-font-file>"
    },
    {
      "name": "CustomFont",
      "weight": "bold",
      "style": "normal",
      "buffer": "<base64-encoded-font-file>"
    }
  ]
}

Style System

The style system uses a two-layer merge approach: you define document-wide default styles in the

styles

object, and optionally override any property per content block using the block's

styles

field.

The

styles

object contains defaults for all block types:

Field	Type	Required	Description
`text`	object	No	Default text/paragraph style
`headline`	object	No	Default headline style
`link`	object	No	Default link style
`list`	object	No	Default list style
`table`	object	No	Default table style
`grid`	object	No	Default grid style
`separator`	object	No	Default separator style
`image`	object	No	Default image style

Text Style

Field	Type	Required	Description
`font_family`	string	Yes	Font family name
`font_size_in_pt`	float	Yes	Font size in points (>= 1)
`line_height`	float	Yes	Line height multiplier (>= 0.5)
`color`	string	Yes	Text color as hex (e.g., `#000000` )
`font_weight`	string	No	Font weight: `thin` , `extralight` , `light` , `regular` , `medium` , `semibold` , `bold` , `extrabold` , `black` . PDF/EPUB render all weights. DOCX/PPTX map `semibold` and above to bold.
`is_italic`	boolean	No	Italic text

Headline Style

Field	Type	Required	Description
`font_family`	string	Yes	Font family name
`font_size_in_pt`	float	Yes	Font size in points (>= 1)
`color`	string	Yes	Headline color as hex
`spacing_before_in_pt`	float	Yes	Space before the headline (>= 0)
`spacing_after_in_pt`	float	Yes	Space after the headline (>= 0)
`font_weight`	string	No	Font weight: `thin` , `extralight` , `light` , `regular` , `medium` , `semibold` , `bold` , `extrabold` , `black` . PDF/EPUB render all weights. DOCX/PPTX map `semibold` and above to bold.
`is_italic`	boolean	No	Italic text

Link Style

Field	Type	Required	Description
`color`	string	Yes	Link color as hex
`is_underlined`	boolean	No	Whether links are underlined

List Style

Field	Type	Required	Description
`text_style`	object	Yes	Text style for list items (same fields as text style)
`marker_color`	string	Yes	Bullet/number color as hex
`marker_gap_in_pt`	float	Yes	Gap between marker and text (>= 0)

Table Style

Field Type Required Description

header

object

Yes

Header row style:

background_color

text_color

font_size_in_pt

font_weight

body

object

Yes

Body row style:

background_color

text_color

font_size_in_pt

border

object

Yes

Border style with

outer

(top, right, bottom, left) and

inner

(horizontal, vertical) -- each with

color

and

width_in_pt

Grid Style

Field	Type	Required	Description
`background_color`	string	Yes	Grid background color as hex
`border_color`	string	Yes	Grid border color as hex
`border_width_in_pt`	float	Yes	Border width in points (>= 0)
`gap_in_pt`	float	Yes	Gap between columns in points (>= 0)

Separator Style

Field	Type	Required	Description
`color`	string	Yes	Line color as hex
`thickness_in_pt`	float	Yes	Line thickness in points (>= 0)
`spacing_before_in_pt`	float	Yes	Space before the separator (>= 0)
`spacing_after_in_pt`	float	Yes	Space after the separator (>= 0)

Image Style

Field	Type	Required	Description
`border_color`	string	Yes	Border color as hex
`border_width_in_pt`	float	Yes	Border width in points (>= 0)

Content Blocks

Content blocks are the building blocks of your document. They are provided as an ordered array in the

content

field and rendered sequentially.

paragraph

A text paragraph composed of one or more rich text runs. Each run can have independent bold, italic, and link formatting. Alternatively, use

markdown

for simple Markdown-formatted text.

Field	Type	Required	Description
`type`	string	Yes	`"paragraph"`
`runs`	array	No	Array of text runs (see below)
`markdown`	string	No	Markdown-formatted text (alternative to `runs` )
`text_alignment`	string	No	One of: `left` , `center` , `right` , `justify`
`styles`	object	No	Text style overrides

Text run:

Field	Type	Required	Description
`text`	string	Yes	The text content (min 1 character)
`font_weight`	string	No	Font weight (same values as text style)
`is_italic`	boolean	No	Italic formatting
`link_url`	string	No	Makes the run a hyperlink

{
  "type": "paragraph",
  "runs": [
    {
      "text": "Visit our "
    },
    {
      "text": "website",
      "font_weight": "bold",
      "link_url": "https://example.com"
    },
    {
      "text": " for details."
    }
  ],
  "text_alignment": "justify"
}

headline

A heading from level h1 to h6. Optionally participates in the table of contents.

Field	Type	Required	Description
`type`	string	Yes	`"headline"`
`level`	string	Yes	One of: `h1` , `h2` , `h3` , `h4` , `h5` , `h6`
`text`	string	Yes	Headline text (min 1 character)
`styles`	object	No	Headline style overrides
`table_of_contents`	object	No	Table of contents settings (see below)

Table of contents options:

Field Type Required Description

is_included

boolean

Whether this headline appears in the TOC

label_override

string

Custom label in the TOC (min 1 character)

level_override

string

Override the TOC indentation level (

h1

h6

)

{
  "type": "headline",
  "level": "h2",
  "text": "Chapter 1: Introduction",
  "table_of_contents": {
    "is_included": true
  }
}

image

An inline image with specified dimensions.

Field	Type	Required	Description
`type`	string	Yes	`"image"`
`buffer`	string	Yes	Base64-encoded image data
`width_in_pt`	float	Yes	Display width in points (>= 1)
`height_in_pt`	float	Yes	Display height in points (>= 1)
`fit`	string	No	One of: `cover` , `contain`
`styles`	object	No	Image style overrides

{
  "type": "image",
  "buffer": "<base64-encoded-image>",
  "width_in_pt": 400.0,
  "height_in_pt": 300.0,
  "fit": "contain"
}

table

A data table with optional header row, column widths, and cell-level formatting.

Field	Type	Required	Description
`type`	string	Yes	`"table"`
`header`	object	No	Header row with `cells` array
`rows`	array	Yes	Array of row objects, each with a `cells` array
`column_widths_in_percent`	array	No	Column width percentages (each >= 1)
`styles`	object	No	Table style overrides

Table cell:

Field	Type	Required	Description
`text`	string	Yes	Cell content (min 1 character)
`horizontal_alignment`	string	No	One of: `left` , `center` , `right`
`column_span`	integer	No	Number of columns to span (>= 1)
`row_span`	integer	No	Number of rows to span (>= 1)
`styles`	object	No	Cell-level style overrides: `background_color` , `text_color` , `font_size_in_pt` , `font_weight` , `is_italic`

{
  "type": "table",
  "header": {
    "cells": [
      {
        "text": "Product"
      },
      {
        "text": "Qty",
        "horizontal_alignment": "right"
      },
      {
        "text": "Price",
        "horizontal_alignment": "right"
      }
    ]
  },
  "rows": [
    {
      "cells": [
        {
          "text": "Widget A"
        },
        {
          "text": "100",
          "horizontal_alignment": "right"
        },
        {
          "text": "$9.99",
          "horizontal_alignment": "right"
        }
      ]
    }
  ],
  "column_widths_in_percent": [50.0, 25.0, 25.0]
}

grid

A 12-column grid layout for placing content blocks side by side. Each column specifies a

column_span

(1-12) and contains its own array of content blocks.

Field	Type	Required	Description
`type`	string	Yes	`"grid"`
`columns`	array	Yes	Array of column objects (see below)
`horizontal_alignment`	string	No	One of: `left` , `center` , `right`
`vertical_alignment`	string	No	One of: `top` , `center` , `bottom`
`styles`	object	No	Grid style overrides

Grid column:

Field	Type	Required	Description
`column_span`	integer	Yes	Number of columns to span (1-12)
`horizontal_alignment`	string	No	One of: `left` , `center` , `right`
`vertical_alignment`	string	No	One of: `top` , `center` , `bottom`
`blocks`	array	Yes	Content blocks within the column

{
  "type": "grid",
  "columns": [
    {
      "column_span": 6,
      "blocks": [
        {
          "type": "headline",
          "level": "h3",
          "text": "Left Column"
        },
        {
          "type": "paragraph",
          "runs": [
            {
              "text": "Content on the left."
            }
          ]
        }
      ]
    },
    {
      "column_span": 6,
      "blocks": [
        {
          "type": "headline",
          "level": "h3",
          "text": "Right Column"
        },
        {
          "type": "paragraph",
          "runs": [
            {
              "text": "Content on the right."
            }
          ]
        }
      ]
    }
  ]
}

list

An ordered or unordered list with support for nested items.

Field	Type	Required	Description
`type`	string	Yes	`"list"`
`variant`	string	Yes	`"ordered"` or `"unordered"`
`items`	array	Yes	Array of list items (see below)
`styles`	object	No	List style overrides

List item:

Field	Type	Required	Description
`text`	string	Yes	Item text (min 1 character)
`children`	array	No	Nested list items

{
  "type": "list",
  "variant": "unordered",
  "items": [
    {
      "text": "First item"
    },
    {
      "text": "Second item",
      "children": [
        {
          "text": "Nested item A"
        },
        {
          "text": "Nested item B"
        }
      ]
    },
    {
      "text": "Third item"
    }
  ]
}

table-of-contents

An auto-generated table of contents built from headline blocks that have

table_of_contents.is_included

set to

true

Field	Type	Required	Description
`type`	string	Yes	`"table-of-contents"`
`levels`	array	Yes	Which headline levels to include (e.g., `["h1", "h2", "h3"]` )
`leader`	string	Yes	Leader style between title and page number: `"dots"` or `"none"`
`text_alignment`	string	No	One of: `left` , `center` , `right` , `justify`
`styles`	object	No	Text style overrides

{
  "type": "table-of-contents",
  "levels": ["h1", "h2", "h3"],
  "leader": "dots"
}

page-break

Forces a page break at this point. In PPTX output, each page-break creates a new slide.

{
  "type": "page-break"
}

separator

A horizontal rule/divider line.

Field	Type	Required	Description
`type`	string	Yes	`"separator"`
`styles`	object	No	Separator style overrides

{
  "type": "separator"
}

page-number

Renders the current page number. Only valid in headers and footers.

Field Type Required Description

type

string

Yes

"page-number"

text_alignment

string

One of:

left

center

right

justify

styles

object

Text style overrides

{
  "type": "page-number",
  "text_alignment": "center"
}

qr-code

Renders a QR code from a string value.

Field	Type	Required	Description
`type`	string	Yes	`"qr-code"`
`value`	string	Yes	Data to encode (min 1 character)
`width_in_pt`	integer	Yes	Width in points (>= 1)
`height_in_pt`	integer	Yes	Height in points (>= 1)
`fg_hex_color`	string	Yes	Foreground color as hex (e.g., `#000000` )
`bg_hex_color`	string	Yes	Background color as hex (e.g., `#FFFFFF` )

{
  "type": "qr-code",
  "value": "https://example.com",
  "width_in_pt": 100,
  "height_in_pt": 100,
  "fg_hex_color": "#000000",
  "bg_hex_color": "#FFFFFF"
}

barcode

Renders a barcode in one of several standard formats.

Field	Type	Required	Description
`type`	string	Yes	`"barcode"`
`value`	string	Yes	Data to encode (min 1 character)
`format`	string	Yes	One of: `code128` , `ean13` , `ean8` , `code39` , `itf` , `codabar`
`width_in_pt`	integer	Yes	Width in points (>= 1)
`height_in_pt`	integer	Yes	Height in points (>= 1)
`fg_hex_color`	string	Yes	Foreground color as hex
`bg_hex_color`	string	Yes	Background color as hex

{
  "type": "barcode",
  "value": "1234567890128",
  "format": "ean13",
  "width_in_pt": 200,
  "height_in_pt": 80,
  "fg_hex_color": "#000000",
  "bg_hex_color": "#FFFFFF"
}

Headers and Footers

Headers and footers accept the same content block types as the document body, with the addition of

page-number

and the exclusion of

table-of-contents

and

page-break

. They are rendered on every page.

Supported block types in headers/footers:

paragraph

headline

image

table

grid

list

page-number

separator

qr-code

barcode

{
  "header": [
    {
      "type": "paragraph",
      "runs": [
        {
          "text": "Acme Corp -- Confidential"
        }
      ],
      "text_alignment": "right"
    }
  ],
  "footer": [
    {
      "type": "grid",
      "columns": [
        {
          "column_span": 6,
          "blocks": [
            {
              "type": "paragraph",
              "runs": [
                {
                  "text": "Acme Corp"
                }
              ]
            }
          ]
        },
        {
          "column_span": 6,
          "blocks": [
            {
              "type": "page-number",
              "text_alignment": "right"
            }
          ]
        }
      ]
    }
  ],
  "header_distance_from_edge_in_pt": 36.0,
  "footer_distance_from_edge_in_pt": 36.0
}

PPTX Notes

When generating PPTX (PowerPoint) output:

The initial content before the first
```
page-break
```
becomes the first slide.
Each
```
page-break
```
block creates a new slide.
All content blocks between page breaks are placed on the same slide.
Page size settings map to slide dimensions.

Format Compatibility

Not all features are supported equally across output formats. The table below shows per-format feature support:

Feature	PDF	DOCX	PPTX	EPUB
Paragraph (rich text)	✅	✅	✅	✅
Headline (h1-h6 sizes)	✅	✅	✅	✅
Image	✅	✅	✅	✅
QR Code	✅	✅	✅	✅
Barcode	✅	✅	✅	✅
Table	✅	✅	✅	✅
Grid (columns)	✅	✅	✅	✅
List (ordered/unordered)	✅	✅	✅	✅
Nested lists	✅	✅	✅	✅
Table of Contents	✅	✅	✅	✅
Page Break	✅	✅	✅	✅
Separator	✅	✅	✅	✅
Page Number	✅	✅	✅	❌
Header / Footer	✅	✅	❌	❌
Font Weight (thin–black)	✅	⚠️	⚠️	✅
Custom Fonts	✅	✅	✅	✅
Page Background Color	✅	✅	✅	❌
Table Cell Backgrounds	✅	✅	✅	✅

Notes:

Font Weight (DOCX/PPTX): DOCX and PPTX only support bold on/off. Weights
```
semibold
```
,
```
bold
```
,
```
extrabold
```
, and
```
black
```
render as bold. All lighter weights (
```
thin
```
through
```
medium
```
) render as normal. PDF and EPUB render the full 100--900 numeric weight range, so all weights are visually distinct when the font supports them.
Table of Contents (DOCX): DOCX table of contents entries are inserted as static text. To make them interactive with page numbers in Microsoft Word, right-click the TOC and select "Update Field" after opening the document.

Recipes

For complete, runnable examples see the Recipes page.

Generate PDF Invoice -- Generate a professional PDF invoice with company branding, line items, and totals.
Generate PDF Report -- Generate a professional PDF report with title, executive summary, data table, and footer.
Generate DOCX Contract -- Generate an editable DOCX service agreement with parties, terms, and payment schedule.
Generate Shipping Label -- Generate a compact PDF shipping label with sender and recipient addresses, barcode, and tracking number.
Generate Restaurant Menu -- Generate a branded restaurant menu PDF with sections, items, prices, and descriptions.

Error Responses

Status	Description
400	Invalid request (validation errors, missing required fields, invalid base64 font data)
401	Missing or invalid API key
422	Processing error (document rendering failure)
429	Rate limit exceeded

Skills document-generation-api

Document Generation API

Prerequisites

API Reference

Key Features

Overview

Request Format

Document Structure

Async Mode

Metadata

Page Settings

Custom Fonts

Style System

Text Style

Headline Style

Link Style

List Style

Table Style

Grid Style

Separator Style

Image Style

Content Blocks

paragraph

headline

image

table

grid

list

table-of-contents

page-break

separator

page-number

qr-code

barcode

Headers and Footers

PPTX Notes

Format Compatibility

Recipes

Error Responses

Links