List the Odoo models a template can bind to (live from the customer's Odoo when a connector is configured, else bundled samples). Use the model value as layout.bind_model.

Fields of an Odoo model, plus paths: dotted paths one relation deep (partner_id.name, order_line.price_subtotal). A path with in_table belongs inside a table (repeater) bound to that value, where you write it as row_path (e.g. {{ price_subtotal }}).

Search real records in the customer's Odoo (needs a configured connector) to pick a record_id for get_values / render_preview.

The record previews are rendered with (real when a connector is configured, else the bundled sample): shows the data shape.

List the account's templates (id, name, bind_model, slot_count).

Get one template with its full layout and mapping.

Create a template from a Studio layout {bind_model, slots[], master_refs?, translations?}. The layout is validated first; on errors nothing is saved and the errors carry JSON paths.

Change a template. Either send a whole new layout, or edit in place: upsert_slots adds slots or replaces those with the same id, delete_slots removes top-level slots by id, layout_set sets top-level keys such as master_refs or translations (null removes).

Delete a template.

Copy a template (default name: ' (copy)').

Validate a layout without saving: returns {ok, errors[], warnings[], stats}. Each issue has a JSON path (slots[3].row_template[1].content), a code and a message. With evaluate=true every expression is also run against a sample record; runtime failures come back as warnings.

What every {{ }} expression prints for one record, per slot (slots: path, template, value/error) and per table row (tables). Pass template_id for a saved template or layout for a draft. The cheapest way to check expressions without reading a PDF. language picks formatDate's "short"/"long"/"datetime" presets; timezone (IANA, Europe/Kyiv) is where datetimes print, unless the live record brings the document's own.

Render a preview (PREVIEW watermark, no credits) of a saved template (template_id) or an unsaved layout. output=html returns the HTML inline; pdf/png are saved to a local file and the path is returned (png = page 1). With output=png and show=true (default) the image itself comes back too: look at it to judge the design (alignment, overlaps, clipped text, contrast) and iterate.

Starting points: blank, quotation, invoice, purchase, product, each with the styles it comes in (classic, folder, wave, diagonal, sidebar, bigtotal) and whether a style uses the shared header/footer.

Create a template from a starter layout (same as Studio's New template dialog). style picks the look (default classic): folder = light band with a folder tab, wave = dark wave header, diagonal = dark band with a slanted edge, sidebar = coloured column, bigtotal = the amount to pay set large. Every colour is a theme reference, so update_template(layout_set={"theme": {...}}) rebrands it. theme picks a palette and fonts at creation: a palette key ("ocean"), or {"palette": "ocean", "fonts": "editorial", } (list_starters lists presets.palettes and presets.fonts). Classic reuses the shared 'Company header'/'Company footer' parts (created on first use); the bold styles draw their own letterhead. model is only for the blank starter.

Read this before designing. Everything a layout can hold, from the same rules the validator applies: slot kinds and their keys with types and allowed values (text: letterSpacing, lineHeight, textTransform, valign, bgColor...; image: mask, grayscale; every slot: opacity, shadow, rotation, blendMode), the paint format (hex, theme., or a linear/radial gradient object), the path kind (free vector drawing: viewBox + paths[{d, fill, gradient, stroke, ...}]), page background, theme keys, bundled fonts, page sizes, limits, and ready path_recipes (folder tab, wave, diagonal band, chevron, hexagon, blob, corner arc) to copy into a path slot.

Turn an SVG (a logo, an illustration, a shape drawn elsewhere) into a path slot body: returns {viewBox, paths, warnings, box, keepAspect}. Pass the markup as svg, or path to a local .svg file (max 1 MB). Create the slot as {"kind": "path", "x", "y", "w": box.w, "h": box.h, "viewBox", "keepAspect", "paths"}, or pass w/h for the size you will place it at (stroke widths are in pt for that size). Text, images, filters and masks are dropped and listed in warnings.

Look at a starter style before creating anything: page 1 on a fixed sample document, re-skinned by a palette and a font pairing (preset keys from list_starters), as an image. Width 240-960 px. Use it to compare styles and palettes with the user, then create_from_starter(starter, name, style=..., theme=palette).

List the shared header/footer parts (templates use them through layout.master_refs = {header: id, footer: id}).

Create a header or footer part: {slots[]} in page coordinates (a header near the top, a footer near the bottom of the A4 page).

Update a part's name, description and/or layout. Every template that uses the part changes with it.

Delete a part. Refused (part_in_use) while templates use it, unless force=true.

Every translatable string of a PDF template (kind=pdf, header and footer parts included) or an email template (kind=email: subject and body text), with its translation per target language, a status per language (translated, inherited, override, invalid, missing), glossary suggestions for missing cells and missing counts per language. A string that prints values keeps them as {{ placeholders }}; an email string keeps its inline tags (b, strong, i, em, u, a, span, code, br) as numbered placeholders <1>...</1> and <2/>, listed in placeholders (the element each stands for in tags).

Translate a template, many languages in one call. translations = {lang: {source string: text}} (lang: de, de_DE, fr_CH...; source strings exactly as get_translations lists them; null deletes a cell). A translation must keep exactly the source's {{ expressions }} and, in an email, its numbered tags <1>...</1>, <2/> (any order, each tag closed after it opens), else nothing is saved and the errors say which. replace=true replaces each language sent as a whole (PUT); default merges (PATCH). fill_from_glossary fills empty cells of the given languages from the built-in glossary. Returns the updated report plus changed and warnings.

List the account's HTML email templates (sent from Odoo by the connector's 'Send by email' wizard).

Get one email template: subject, body_html, translations and the record fields it reads.

Create an email template. Subject and body use the PDF templates' expressions: {{ expr }} prints a value HTML-escaped, {{{ expr }}} inserts it as cleaned HTML. Use inline styles and tables (email clients). {{ odoo_url }} is the connected Odoo's https address: {{ odoo_url }}/logo.png?company={{ company_id.id }} is the company logo. attach_template_id = a PDF template to attach when sent.

Change an email template; only the fields given change. remove_attachment=true stops attaching a PDF.

Delete an email template.

Render an email for one record: a saved one (email_template_id) or a draft (subject + body_html, optional translations). language (de_DE, fr...) shows it as a customer with that language gets it; timezone (IANA) is where its datetimes print. Returns {subject, html, errors, source, record}; no credits.