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.

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.

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

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.

Delete an email template.

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

Delete a template.

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

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.

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

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 }}).

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

Get one template with its full layout and mapping.

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).

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.

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.

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

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.

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

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.

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

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.

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).

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.

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

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.

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

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

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).

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.