Deterministic, fully editable PowerPoint from typed slide intents. 200+ layouts, brand templates.
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Browse the PowerPoint slide catalog progressively. No args -> form overview (when-to-use, bound fields, variant counts). family=<form> -> variant one-liners. q=<text> -> ranked search. variant=/prior_id= -> example payload. type=schema + family -> a compact family-level variant chooser (not a sendable contract); type=schema + family + variant -> that variant's exact payload contract (JSON Schema, capacity, field mapping, examples). Free. Code path: type=widgets = the add_widget() catalog (name=<widget> for its contract + thumbnail); type=helpers = python-pptx helper signatures. type=themes + an uploaded theme_id -> that template's branded FURNITURE layouts (its own cover/agenda/divider/closing slides + fill schemas + previews) — render via create_slide(form=template_layout, theme_id, data={layout, fills}).
Semantic search across all variants; returns ranked form/variant matches with scores.
Max results (with type=themes).
Widget name (with type=widgets): returns the full contract + worked example + a rendered thumbnail.
Omit for the form overview (or family=/q= to drill in). schema (+family, optionally +variant=) = schema-first discovery: family only returns a compact variant chooser; family+variant returns that variant's exact machine-readable payload contract (JSON Schema for data, capacity limits, intent-field mapping, examples). widgets = the add_widget() catalog for mode=code (name=<widget> for its contract). helpers = python-pptx helper signatures. themes = list themes (built-in + your saved); Default appears first and can be omitted, or use any returned id as theme_id. brands = your brand kits with versions (theme_id=<slug> renders the default version, <slug>@<n> pins n).
Max results (with q= or family=).
Pagination offset (with q= or family=).
Theme source filter (with type=themes). Default all (built-in + your saved).
With type=themes: an uploaded theme's id -> its branded furniture layouts + fill schemas (render via create_slide(form=template_layout)).
Browse the PowerPoint slide catalog progressively. No args -> form overview (when-to-use, bound fields, variant counts). family=<form> -> variant one-liners. q=<text> -> ranked search. variant=/prior_id= -> example payload. type=schema + family -> a compact family-level variant chooser (not a sendable contract); type=schema + family + variant -> that variant's exact payload contract (JSON Schema, capacity, field mapping, examples). Free. Code path: type=widgets = the add_widget() catalog (name=<widget> for its contract + thumbnail); type=helpers = python-pptx helper signatures. type=themes + an uploaded theme_id -> that template's branded FURNITURE layouts (its own cover/agenda/divider/closing slides + fill schemas + previews) — render via create_slide(form=template_layout, theme_id, data={layout, fills}).
| Argument | Type | Description |
|---|---|---|
| q | string | Semantic search across all variants; returns ranked form/variant matches with scores. |
| top | integer | Max results (with type=themes). |
| name | string | Widget name (with type=widgets): returns the full contract + worked example + a rendered thumbnail. |
| type | string | Omit for the form overview (or family=/q= to drill in). schema (+family, optionally +variant=) = schema-first discovery: family only returns a compact variant chooser; family+variant returns that variant's exact machine-readable payload contract (JSON Schema for data, capacity limits, intent-field mapping, examples). widgets = the add_widget() catalog for mode=code (name=<widget> for its contract). helpers = python-pptx helper signatures. themes = list themes (built-in + your saved); Default appears first and can be omitted, or use any returned id as theme_id. brands = your brand kits with versions (theme_id=<slug> renders the default version, <slug>@<n> pins n). |
| limit | integer | Max results (with q= or family=). |
| family | string | |
| offset | integer | Pagination offset (with q= or family=). |
| source | string | Theme source filter (with type=themes). Default all (built-in + your saved). |
| variant | string | |
| prior_id | string | |
| theme_id | string | With type=themes: an uploaded theme's id -> its branded furniture layouts + fill schemas (render via create_slide(form=template_layout)). |
{
"type": "object",
"properties": {
"q": {
"type": "string",
"description": "Semantic search across all variants; returns ranked form/variant matches with scores."
},
"top": {
"type": "integer",
"description": "Max results (with type=themes)."
},
"name": {
"type": "string",
"description": "Widget name (with type=widgets): returns the full contract + worked example + a rendered thumbnail."
},
"type": {
"type": "string",
"description": "Omit for the form overview (or family=/q= to drill in). schema (+family, optionally +variant=) = schema-first discovery: family only returns a compact variant chooser; family+variant returns that variant's exact machine-readable payload contract (JSON Schema for data, capacity limits, intent-field mapping, examples). widgets = the add_widget() catalog for mode=code (name=<widget> for its contract). helpers = python-pptx helper signatures. themes = list themes (built-in + your saved); Default appears first and can be omitted, or use any returned id as theme_id. brands = your brand kits with versions (theme_id=<slug> renders the default version, <slug>@<n> pins n)."
},
"limit": {
"type": "integer",
"description": "Max results (with q= or family=)."
},
"family": {
"type": "string"
},
"offset": {
"type": "integer",
"description": "Pagination offset (with q= or family=)."
},
"source": {
"enum": [
"all",
"default",
"custom",
"saved",
"uploaded"
],
"type": "string",
"description": "Theme source filter (with type=themes). Default all (built-in + your saved)."
},
"variant": {
"type": "string"
},
"prior_id": {
"type": "string"
},
"theme_id": {
"type": "string",
"description": "With type=themes: an uploaded theme's id -> its branded furniture layouts + fill schemas (render via create_slide(form=template_layout))."
}
}
}Create a complete PowerPoint presentation (.pptx): a whole multi-slide deck, native and editable, in one call. `slides` is a list of create_slide intents (same form menu + data shapes — see create_slide). Slides fill in parallel and merge into one themed PPTX with page numbers. Include furniture: a hero_statement cover, section_divider breaks, and a closing (hero_statement variant=contact_closing via blocks-free slots). BLOCKED (not billed)? If an error has `can_autofix:true`, merge its `patch` into the args at `patch_target`. Unchanged retries repeat the block. New form: browse_catalog(type=schema) first. Also: mode=assemble merges existing slide job_ids as-rendered (free; theme_id does NOT re-theme them — render with create_deck(slides=[…], theme_id=…) for a unified theme); mode=fork clones a deck (free). Polling: deck_id == job_id — manage_account(action=job, job_id=<deck_id>).
| Argument | Type | Description |
|---|---|---|
| mode | string | Default render. assemble/fork are free deck plumbing. |
| name | string | |
| title | string | Deck title (PowerPoint metadata) |
| slides | array | each item is a create_slide intent (same form menu, typed fields, and data shapes as create_slide). |
| deck_id | string | Existing deck ID (for mode=fork, or mode=render to update) |
| dry_run | boolean | Deck-level free pre-flight (cost:0, NO render/PPTX): returns a per-slide validation manifest [{i, form, fidelity_forecast, status, errors}] so you can fix bad slides before spending. A deck is one artifact, so validation is all-or-nothing — put dry_run here, not on individual slides. Resend without dry_run to render. |
Create one PowerPoint slide (.pptx, native, editable) from a structured intent in ONE call: pick a `form` from the menu and put your content in the typed fields (placed on the slide as given), or pass a `brief` and let the server route it. Fields tagged (per-form) bind only where the form has that slot — ignored-with-warning elsewhere; see each form's `binds` in browse_catalog. BLOCKED (not billed)? If an error has `can_autofix:true`, merge its `patch` into the args at `patch_target`. Unchanged retries repeat the block. New form: browse_catalog(type=schema) first. FORM MENU: agenda_list: an ordered list of sections/topics or learning objectives to walk through bar_rank_chart: bars comparing magnitudes across categories calendar_grid: events on a real calendar - week planner (day x hour) or month grid with event chips (data.events) card_grid: several equal, unordered peer blocks (features, options, pillars, a concept's defined parts, rules/guidelines/common mistakes) case_story: one named story told as evidence, proven by measured results (data.results = figures) comparison_matrix: options x criteria grid: data.columns x data.rows cycle_flow: a closed loop of ordered stages where the last feeds the first (recurring process) data_table: a plain factual table of records by fields editorial_split: two side-by-side halves: contrast (before/after, problem/solution) or copy/numbered steps beside a picture (image_src) exercise_prompt: an exercise/practice/discussion prompt: instruction + hints; optional problem items with blank answer boxes funnel: a quantity narrowing through ordered stages gantt_plan: tasks as bars across named periods on a schedule grid gauge_score: one score on a dial against a scale hero_statement: a statement slide: covers (title/image-led/exec), from->to/thesis-quote transitions, statement/contact/next-steps closings; supporting points -> takeaway_stack, contacts -> data.contacts, next steps -> data.next_steps hub_spoke: one central element with several elements connected around it image_story: a picture shown WHOLE (uncropped) + prose and up to 4 labelled blocks beside it, or a 1-6 picture/placeholder gallery (data.images) kpi_metrics: a metrics dashboard: headline metric cards; data.sections (Highlights/Risks/Asks) makes it an exec summary / QBR snapshot layer_stack: stacked layers where higher sits on, and depends on, lower linear_flow: ordered process stages read left to right (or inputs to process to outputs) maturity_staircase: ascending levels climbing to a higher state nested_magnitude: nested containment - each level contains the next org_structure: a reporting hierarchy / org tree position_map: items placed by two axes - named 2x2 cells or scatter positions pyramid_hierarchy: a triangle of stacked tiers, foundation to apex ramp_curve: a continuous rising wedge split into phases - effort or value accumulating over time section_divider: a section-break: big section number + title; blocks = agenda progress chips (emphasis=primary = current) segment_wheel: a wheel of equal segments around a center - peer categories in the round (composition, not flow) status_dashboard: initiatives/workstreams tracked by status, owner, progress strategic_fork: one origin splitting into two mutually exclusive paths, one recommended swimlane_flow: actor/function lanes by phases, task cells, handoffs across lanes swot: the four-quadrant strengths / weaknesses / opportunities / threats grid system_flow_map: architecture/system components: panels with internals (edges optional) or nodes wired by directed arrows takeaway_stack: a title plus a few supporting points, each with one line of detail (executive summary, key findings); optional closing ask timeline_roadmap: milestones/phases laid out along a time axis trend_chart: one or more series plotted over time value_chain: support bands over primary activity columns flowing into a goal arrowhead (data.support = the bands) visual_showcase: one dominant screenshot/image with numbered callouts pointing into it waterfall_bridge: a start value bridged to an end value by plus/minus contributions Exact per-form data shapes: browse_catalog(type=schema, family=<form>) — the generated,always-current JSON Schema + a worked example. (List-shaped forms take `blocks`: [{"label","sub","detail":[str],"emphasis"}]; structured forms take typed `data`.) Escape modes: mode=code (caller-supplied python-pptx in sandbox — use for forms the menu cannot express: calendars, custom diagrams); mode=status (poll a job, free). Image-led asks (photo covers, full-bleed visuals): hero_statement + image_prompt or image_src.
Change one or more slides of a deck you already rendered, in place and free: only the patched slides re-render, the deck is re-merged and keeps its id and links. Never runs a model: a brief or a picture request is refused. Each edited slide's entry carries its full current spec as `intent`. Up to 20 edits per deck.
| Argument | Type | Description |
|---|---|---|
| job_id* | string | the deck's job_id |
| slides* | array |
{
"type": "object",
"required": [
"job_id",
"slides"
],
"properties": {
"job_id": {
"type": "string",
"description": "the deck's job_id"
},
"slides": {
"type": "array",
"items": {
"type": "object",
"required": [
"slide",
"patch"
],
"properties": {
"patch": {
"type": "object",
"properties": {
"data": {
"type": "object",
"description": "family-specific payload — see the documented shapes"
},
"date": {
"type": "string",
"description": "date callout (per-form)."
},
"form": {
"type": "string",
"description": "the form menu pick (see description) — the routing field"
},
"notes": {
"type": "string",
"description": "Speaker notes for the presenter; never drawn on the slide."
},
"blocks": {
"type": "array",
"items": {
"type": "object"
},
"description": "list: [{\"label\",\"sub\",\"detail\":[str],\"emphasis\",\"icon\":lucide-name,\"metric\":{value,label}}]"
},
"metric": {
"type": "object"
},
"caution": {
"type": "string",
"description": "one-line risk / caveat callout (per-form)."
},
"context": {
"type": "string",
"description": "one-line subtitle/standfirst"
},
"imagery": {
"enum": [
"photo",
"wash",
"off"
],
"type": "string",
"description": "Cover/section-divider imagery: photo (default — curated stock photo, half-bleed), wash (abstract color wash), off (plain panel, no photo — only when asked). Content slides are never photo-decorated."
},
"styling": {
"enum": [
"topical",
"clean"
],
"type": "string",
"description": "Topical design on default themes (default on; the note names it): designed cover + a subject palette (from imagery_tag, or the brief). clean = neutral. Pins never take it."
},
"subject": {
"type": "string",
"description": "central entity for forms that have one — hub label, org root, section #, fork origin, media label (per-form)."
},
"variant": {
"type": "string",
"description": "pin a specific variant within the form (list them via browse_catalog). Unknown variant -> rejected with the valid list; null unpins."
},
"headline": {
"type": "string",
"description": "the assertion-style slide title"
},
"takeaway": {
"type": "string",
"description": "optional verdict band (per-form). Put the so-what in the headline; add only for a verdict the title can't carry — not every slide."
},
"theme_id": {
"type": "string"
},
"direction": {
"enum": [
"ltr",
"rtl"
],
"type": "string",
"description": "rtl typesets AND mirrors the slide right-to-left (Arabic/Hebrew). Never inferred — pass it."
},
"highlight": {
"type": "string",
"description": "one-line emphasis callout (per-form)."
},
"image_src": {
"type": "string",
"description": "https URL | asset:<id> for image-bearing forms"
},
"imagery_tag": {
"enum": [
"general",
"agriculture",
"construction",
"education",
"energy",
"finance",
"government",
"healthcare",
"logistics",
"manufacturing",
"retail",
"technology",
"travel"
],
"type": "string",
"description": "Subject/industry: steers library photos (covers, sections, picture slides) AND the topical palette. Omit = general; `education` = teaching."
},
"min_font_pt": {
"type": "number",
"maximum": 40,
"minimum": 6,
"description": "Binding type floor for prose. Content that can't fit is refused as min_font_not_met naming the size needed. Typical: 12."
},
"source_note": {
"type": "string",
"description": "source / footnote line (per-form)."
},
"variant_policy": {
"enum": [
"best_semantic_match",
"production_safe"
],
"type": "string",
"description": "Routed-variant maturity policy: production_safe = if the ROUTED variant is draft/beta, render the family's demo-safe sibling instead (warning names both). Never overrides an explicit variant=. Default best_semantic_match."
},
"quality_profile": {
"enum": [
"executive",
"technical",
"appendix"
],
"type": "string",
"description": "Thresholds layout.presentation_ready is judged against (executive strictest). Measurement only — never blocks a render or changes cost."
},
"allow_truncation": {
"type": "boolean",
"description": "More items than the form holds blocks (it would drop your data); the response names the dropped count + a suggested_split. true renders the capacity subset (fidelity=verbatim_truncated). Default false."
},
"allow_variant_fallback": {
"type": "boolean",
"description": "If the pinned variant is unknown, render the form's default variant (with a warning) instead of rejecting. Default false."
}
},
"description": "the slide fields to change (same fields as create_slide). A field left out keeps its value, a field sent as null is removed, a list replaces the whole list, `data` merges key by key. Send only `notes` to add or replace speaker notes without a re-render.",
"additionalProperties": true
},
"slide": {
"type": "integer",
"description": "0-based index, as slides[].i in the create_deck response"
}
}
},
"minItems": 1
}
}
}Change a slide you already rendered, in place and free: the job keeps its id and links. Send the job_id and a patch of the fields to change. Never runs a model: a brief or a picture request is refused (make a new slide for those). The response carries the slide's full current spec as `intent`. Up to 20 edits per slide.
| Argument | Type | Description |
|---|---|---|
| patch* | object | the slide fields to change (same fields as create_slide). A field left out keeps its value, a field sent as null is removed, a list replaces the whole list, `data` merges key by key. Send only `notes` to add or replace speaker notes without a re-render. |
| job_id* | string | the rendered slide's job_id |
{
"type": "object",
"required": [
"job_id",
"patch"
],
"properties": {
"patch": {
"type": "object",
"properties": {
"data": {
"type": "object",
"description": "family-specific payload — see the documented shapes"
},
"date": {
"type": "string",
"description": "date callout (per-form)."
},
"form": {
"type": "string",
"description": "the form menu pick (see description) — the routing field"
},
"notes": {
"type": "string",
"description": "Speaker notes for the presenter; never drawn on the slide."
},
"blocks": {
"type": "array",
"items": {
"type": "object"
},
"description": "list: [{\"label\",\"sub\",\"detail\":[str],\"emphasis\",\"icon\":lucide-name,\"metric\":{value,label}}]"
},
"metric": {
"type": "object"
},
"caution": {
"type": "string",
"description": "one-line risk / caveat callout (per-form)."
},
"context": {
"type": "string",
"description": "one-line subtitle/standfirst"
},
"imagery": {
"enum": [
"photo",
"wash",
"off"
],
"type": "string",
"description": "Cover/section-divider imagery: photo (default — curated stock photo, half-bleed), wash (abstract color wash), off (plain panel, no photo — only when asked). Content slides are never photo-decorated."
},
"styling": {
"enum": [
"topical",
"clean"
],
"type": "string",
"description": "Topical design on default themes (default on; the note names it): designed cover + a subject palette (from imagery_tag, or the brief). clean = neutral. Pins never take it."
},
"subject": {
"type": "string",
"description": "central entity for forms that have one — hub label, org root, section #, fork origin, media label (per-form)."
},
"variant": {
"type": "string",
"description": "pin a specific variant within the form (list them via browse_catalog). Unknown variant -> rejected with the valid list; null unpins."
},
"headline": {
"type": "string",
"description": "the assertion-style slide title"
},
"takeaway": {
"type": "string",
"description": "optional verdict band (per-form). Put the so-what in the headline; add only for a verdict the title can't carry — not every slide."
},
"theme_id": {
"type": "string"
},
"direction": {
"enum": [
"ltr",
"rtl"
],
"type": "string",
"description": "rtl typesets AND mirrors the slide right-to-left (Arabic/Hebrew). Never inferred — pass it."
},
"highlight": {
"type": "string",
"description": "one-line emphasis callout (per-form)."
},
"image_src": {
"type": "string",
"description": "https URL | asset:<id> for image-bearing forms"
},
"imagery_tag": {
"enum": [
"general",
"agriculture",
"construction",
"education",
"energy",
"finance",
"government",
"healthcare",
"logistics",
"manufacturing",
"retail",
"technology",
"travel"
],
"type": "string",
"description": "Subject/industry: steers library photos (covers, sections, picture slides) AND the topical palette. Omit = general; `education` = teaching."
},
"min_font_pt": {
"type": "number",
"maximum": 40,
"minimum": 6,
"description": "Binding type floor for prose. Content that can't fit is refused as min_font_not_met naming the size needed. Typical: 12."
},
"source_note": {
"type": "string",
"description": "source / footnote line (per-form)."
},
"variant_policy": {
"enum": [
"best_semantic_match",
"production_safe"
],
"type": "string",
"description": "Routed-variant maturity policy: production_safe = if the ROUTED variant is draft/beta, render the family's demo-safe sibling instead (warning names both). Never overrides an explicit variant=. Default best_semantic_match."
},
"quality_profile": {
"enum": [
"executive",
"technical",
"appendix"
],
"type": "string",
"description": "Thresholds layout.presentation_ready is judged against (executive strictest). Measurement only — never blocks a render or changes cost."
},
"allow_truncation": {
"type": "boolean",
"description": "More items than the form holds blocks (it would drop your data); the response names the dropped count + a suggested_split. true renders the capacity subset (fidelity=verbatim_truncated). Default false."
},
"allow_variant_fallback": {
"type": "boolean",
"description": "If the pinned variant is unknown, render the form's default variant (with a warning) instead of rejecting. Default false."
}
},
"description": "the slide fields to change (same fields as create_slide). A field left out keeps its value, a field sent as null is removed, a list replaces the whole list, `data` merges key by key. Send only `notes` to add or replace speaker notes without a re-render.",
"additionalProperties": true
},
"job_id": {
"type": "string",
"description": "the rendered slide's job_id"
}
}
}SlideForge account for PowerPoint generation: balance, job history, feedback, data controls. All free. Actions: status (balance+plan), usage (spend breakdown), jobs (history), job (single job detail — slide jobs include `quality_warnings[]`; deck jobs add `slides_completed/slides_failed/failed_slides[]`), feedback (submit), feedback_list (read your reports back: status + resolution), onboarding (capabilities overview), download_url (fresh short-TTL PPTX link for an owned job — when a result carries no inline URL), security_status (retention + access-model + deletion posture), delete_job (irreversible: job + versions + files) Action delete_asset irreversibly deletes a user-owned uploaded/generated image asset.
| Argument | Type | Description |
|---|---|---|
| days | integer | Lookback period (for action=usage, default 30) |
| slug | string | Report slug (for action=reports — returns one report's full metadata; omit to list all). |
| limit | integer | Max rows (action=jobs default 10; action=feedback_list default 50, max 100) |
| action* | string | Operation (required). feedback → report a defect or request against a render; pass job_id so it is actionable, and ask the user before filing. feedback_list → read YOUR OWN filed reports back, with `status` and the `resolution` written when one was acted on: check it before working around a defect you reported earlier, because it may already be fixed. brand_report → the per-token fidelity report for one of your brand kits (pass theme_id). reports → list report types. delete_job is irreversible. delete_asset is irreversible for user-owned image assets. |
Plan a PowerPoint slide before rendering (free): send a short brief, get ranked candidates + a separated verdict — route (which slide: selected|needs_confirmation|ambiguous), input (can it render: ready|extractable_from_brief|needs_structured_data) and next_action. Free (one embedding). Then call create_slide with the chosen form(+variant). route.confidence: calibrated = measured P(route correct) with label high/medium/low cut on it; retrieval_score/retrieval_margin = the raw family-aggregated classifier values (not probabilities; margin can be negative when families contest); source = jev (calibrated router, took the route at >=0.9) | classifier | structural_router (LLM-rescued). candidate_margin on the top candidate = literal gap between the two shown scores.
| Argument | Type | Description |
|---|---|---|
| top | integer | |
| brief* | string | |
| escalate | boolean | Default true: on a low-confidence route the plan runs the SAME LLM rescue create_slide would (small COGS on that tail only), so plan and create always agree. Set false for a classifier-only, fully free plan (response then flags will_escalate + create_slide_behavior). |
| variant_policy | string | production_safe: if the top routed variant is draft/beta, the family's demo-safe sibling leads and route reports both best_semantic and best_production_safe. |
{
"type": "object",
"required": [
"brief"
],
"properties": {
"top": {
"type": "integer"
},
"brief": {
"type": "string"
},
"escalate": {
"type": "boolean",
"description": "Default true: on a low-confidence route the plan runs the SAME LLM rescue create_slide would (small COGS on that tail only), so plan and create always agree. Set false for a classifier-only, fully free plan (response then flags will_escalate + create_slide_behavior)."
},
"variant_policy": {
"enum": [
"best_semantic_match",
"production_safe"
],
"type": "string",
"description": "production_safe: if the top routed variant is draft/beta, the family's demo-safe sibling leads and route reports both best_semantic and best_production_safe."
}
}
}Translate a PowerPoint (.pptx) deck preserving all formatting. Supports 35 languages (Latin, Cyrillic, Greek, Chinese, Japanese, Korean). Provide job_id (from a previous create_slide/create_deck), pptx_url, or pptx_base64.
| Argument | Type | Description |
|---|---|---|
| name | string | Job name |
| job_id | string | Source: previous slide/deck job ID (preferred — no file transfer needed) |
| pptx_url | string | Source: HTTPS URL to .pptx |
| pptx_base64 | string | Source: Base64-encoded .pptx (max ~10 MB) |
| concise_mode | boolean | Prefer shorter translations for tight text boxes |
| include_notes | boolean | Translate speaker notes (default false) |
| include_tables | boolean | Translate table cells (default true) |
| include_preview | string | Wait+embed preview (default=wait) |
| source_language | string | Source language or 'auto' (default auto) |
| target_language |
Upload assets for PowerPoint (.pptx) generation: company template, logo, image, or document — or AI-generate an image. Purposes: • logo — company logo for chrome (PNG/JPG/SVG, max 5MB) → logo_id • image — image for the Image component (max 10MB) → asset_id • theme — company template PPTX → theme_id; slides with it render NATIVELY on the template (masters/layouts/chrome) • generate_image — AI-generate via `prompt` → asset_id • translate — PPTX to translate → deck job_id (requires `target_language`) • pdf — PDF → editable slides; pass `target_language` to also translate • recreate — image OF a slide → editable PPTX slide (honest annotate/preserve fallback). Use `image` to just place a picture Files >3MB (pdf/translate/theme) — and recreate on chat hosts — omit `data`: a drop-zone appears in the result card; bytes never pass through the agent.
| Argument | Type | Description |
|---|---|---|
| data | string | Base64-encoded file content. Required for logo/image/theme/translate. Optional for pdf — omit to get a drop-zone (recommended for files >3MB). |
| size | string | Image dimensions for generate_image (default 1024×1024) |
| model | string | Explicit gateway model ID. Overrides `quality`. |
| job_id | string | For purpose=brand: keep the look a recreate rendered in — pass that recreate's job_id and its exact kit is saved as yours (no upload, no charge). |
| prompt | string | Image description (required when purpose=generate_image) |
| purpose* | string |
| imagery | string | Deck-level imagery mode, inherited by every slide (a slide-level imagery wins). See create_slide.imagery. |
| job_ids | array | Slide job IDs to merge (for mode=assemble) |
| logo_id | string | Optional brand logo (from upload_asset purpose=logo) applied as chrome to every content slide in the deck. |
| styling | string | Deck-level topical-design switch, inherited by every slide (a slide-level styling wins). See create_slide.styling. |
| language | string | ISO 639-1 (default en) for every slide: furniture labels and authored fills follow it. |
| theme_id | string |
| direction | string | Deck-level writing direction, inherited by every slide (a slide-level direction wins) — set it once for an Arabic/Hebrew deck. Covers/dividers rendered on an UPLOADED brand template keep that template's own layout direction. See create_slide.direction. |
| imagery_tag | string | Deck-level subject declaration, inherited by every slide (a slide-level imagery_tag wins). Declare it once for a whole deck. See create_slide.imagery_tag. |
| force_render | boolean | IGNORED (deck-level). pptx_url is always returned when at least one slide rendered, so there is nothing to force. Still meaningful on create_slide. |
| allow_partial | boolean | IGNORED. A deck bills per rendered slide and always returns its pptx; slides that failed or rendered badly are free and named in repair_actions. |
| strict_policy | object | Optional CI-style gate for automated report pipelines. dry_run returns policy_result; render returns rejected/cost:0 if the policy fails. |
{
"type": "object",
"required": [],
"properties": {
"mode": {
"enum": [
"render",
"assemble",
"fork"
],
"type": "string",
"description": "Default render. assemble/fork are free deck plumbing."
},
"name": {
"type": "string"
},
"title": {
"type": "string",
"description": "Deck title (PowerPoint metadata)"
},
"slides": {
"type": "array",
"items": {
"type": "object"
},
"description": "each item is a create_slide intent (same form menu, typed fields, and data shapes as create_slide)."
},
"deck_id": {
"type": "string",
"description": "Existing deck ID (for mode=fork, or mode=render to update)"
},
"dry_run": {
"type": "boolean",
"description": "Deck-level free pre-flight (cost:0, NO render/PPTX): returns a per-slide validation manifest [{i, form, fidelity_forecast, status, errors}] so you can fix bad slides before spending. A deck is one artifact, so validation is all-or-nothing — put dry_run here, not on individual slides. Resend without dry_run to render."
},
"imagery": {
"enum": [
"photo",
"wash",
"off"
],
"type": "string",
"description": "Deck-level imagery mode, inherited by every slide (a slide-level imagery wins). See create_slide.imagery."
},
"job_ids": {
"type": "array",
"items": {
"type": "string"
},
"description": "Slide job IDs to merge (for mode=assemble)"
},
"logo_id": {
"type": "string",
"description": "Optional brand logo (from upload_asset purpose=logo) applied as chrome to every content slide in the deck."
},
"styling": {
"enum": [
"topical",
"clean"
],
"type": "string",
"description": "Deck-level topical-design switch, inherited by every slide (a slide-level styling wins). See create_slide.styling."
},
"language": {
"enum": [
"bg",
"ca",
"cs",
"da",
"de",
"el",
"en",
"es",
"et",
"fi",
"fr",
"gl",
"hr",
"hu",
"id",
"is",
"it",
"ja",
"ko",
"lt",
"lv",
"nl",
"no",
"pl",
"pt",
"ro",
"ru",
"sk",
"sl",
"sr",
"sv",
"tr",
"uk",
"vi",
"zh"
],
"type": "string",
"description": "ISO 639-1 (default en) for every slide: furniture labels and authored fills follow it."
},
"theme_id": {
"type": "string"
},
"direction": {
"enum": [
"ltr",
"rtl"
],
"type": "string",
"description": "Deck-level writing direction, inherited by every slide (a slide-level direction wins) — set it once for an Arabic/Hebrew deck. Covers/dividers rendered on an UPLOADED brand template keep that template's own layout direction. See create_slide.direction."
},
"imagery_tag": {
"enum": [
"general",
"agriculture",
"construction",
"education",
"energy",
"finance",
"government",
"healthcare",
"logistics",
"manufacturing",
"retail",
"technology",
"travel"
],
"type": "string",
"description": "Deck-level subject declaration, inherited by every slide (a slide-level imagery_tag wins). Declare it once for a whole deck. See create_slide.imagery_tag."
},
"force_render": {
"type": "boolean",
"description": "IGNORED (deck-level). pptx_url is always returned when at least one slide rendered, so there is nothing to force. Still meaningful on create_slide."
},
"allow_partial": {
"type": "boolean",
"description": "IGNORED. A deck bills per rendered slide and always returns its pptx; slides that failed or rendered badly are free and named in repair_actions."
},
"strict_policy": {
"type": "object",
"properties": {
"max_density": {
"enum": [
"good",
"medium",
"high"
],
"type": "string",
"description": "Reject slides whose quality.density is above this level."
},
"min_font_pt": {
"type": "number",
"description": "Reject slides whose reported minimum font size is below this point size."
},
"reject_mixed": {
"type": "boolean",
"description": "Reject slides with mixed verbatim and AI-completed content."
},
"reject_truncated": {
"type": "boolean",
"description": "Reject slides with truncated supplied content."
},
"reject_ai_completed": {
"type": "boolean",
"description": "Reject slides whose content was fully AI-completed."
},
"reject_draft_variants": {
"type": "boolean",
"description": "Reject slides rendered by a draft-maturity variant (see each slide's variant_maturity warning)."
},
"reject_field_warnings": {
"type": "boolean",
"description": "Reject slides carrying any field-binding warning (field_ignored, input_shape_hint, normalized, variant_fallback, form_rerouted)."
},
"reject_ignored_fields": {
"type": "boolean",
"description": "Reject slides whose supplied fields were not rendered (fidelity=partial / field_ignored)."
}
},
"description": "Optional CI-style gate for automated report pipelines. dry_run returns policy_result; render returns rejected/cost:0 if the policy fails."
}
}
}| Argument | Type | Description |
|---|---|---|
| code | string | Python code defining build(prs). Canvas 13.33×7.5", coords in inches. Pre-imported: Presentation, Inches, Pt, Emu, RGBColor, MSO_ANCHOR, PP_ALIGN. Helpers: add_text_box(slide, left, top, w, h, text, font_size=12, bold=False, color=None), add_box(slide, left, top, w, h, fill_color=None, line_color=None, corner_radius=0.05), add_icon, add_image (src = path or https://); theme_color(name) → RGBColor. add_widget(slide, name, x, y, w, h, params=|content=, theme=THEME) draws board-grade SSG widgets/charts (cards, waterfall, gantt, funnel…) — names via `browse_catalog(type=widgets)`. Use font_size=, not size=; use fill_color=, not fill=. When chrome is supplied, use `build(prs, slide)` — chrome is pre-rendered. Helper signatures: `browse_catalog(type=helpers)`. |
| data | object | family-specific payload — see the documented shapes |
| date | string | date callout (per-form). |
| form | string | the form menu pick (see description) — the routing field |
| mode | string | Default: structured intent / brief. safe = validate-then-render in ONE call (renders + bills only if faithful; else an unbilled invalid report with the fix — recommended, no dry_run round-trip). code = python-pptx escape. status = poll. |
| name | string | |
| wait | string | AI-image slides block ~10-15s; `false` returns a job_id to poll, not block (mode=brief). |
| brief | string | prose fallback / extra context for fills |
| notes | string | Speaker notes for the presenter; never drawn on the slide. |
| blocks | array | list: [{"label","sub","detail":[str],"emphasis","icon":lucide-name,"metric":{value,label}}] |
| detail | string | Response verbosity. Default `compact`: status, form/variant, fidelity (verbatim|mixed|ai_completed), warnings[]/errors[] (only when present), urls, cost. `full` adds a debug object (engine internals, verify events, latency buckets). |
| job_id | string | Previous job ID (for mode=status, or mode=code patching) |
| metric | object | |
| verify | string | mode=code. Default `lint`: static geometry + content checks, no LLM. `lint+vlm` adds a VLM second look (~+3s); a blank render is then an unbilled error, not a billed warning. `off` skips checks. |
| caution | string | one-line risk / caveat callout (per-form). |
| context | string | one-line subtitle/standfirst |
| dry_run | boolean | Free pre-commit check (intent or mode=code), cost:0, no PPTX: status + warnings/errors, plus fidelity_forecast (verbatim|mixed|ai_completed|would_reject) and which fields bind vs get authored. Fix errors, re-call with dry_run=false to render. |
| imagery | string | Cover/section-divider imagery: photo (default — curated stock photo, half-bleed), wash (abstract color wash), off (plain panel, no photo — only when asked). Content slides are never photo-decorated. |
| logo_id | string | Optional brand logo (from upload_asset purpose=logo) drawn as chrome on content slides; covers/section breaks stay clean. |
| styling | string | Topical design on default themes (default on; the note names it): designed cover + a subject palette (from imagery_tag, or the brief). clean = neutral. Pins never take it. |
| subject | string | central entity for forms that have one — hub label, org root, section #, fork origin, media label (per-form). |
| variant | string | pin a specific variant within the form (list them via browse_catalog). Unknown variant -> rejected (not billed) with the valid list; set allow_variant_fallback to render the family default instead. |
| headline | string | the assertion-style slide title |
| language | string | ISO 639-1 (default en): furniture labels and authored fills follow it. |
| takeaway | string | optional verdict band (per-form). Put the so-what in the headline; add only for a verdict the title can't carry — not every slide. |
| theme_id | string | Optional theme id from browse_catalog(type=themes). Omit for Default (slideforge_standard). |
| direction | string | rtl typesets AND mirrors the slide right-to-left (Arabic/Hebrew). Never inferred — pass it. |
| highlight | string | one-line emphasis callout (per-form). |
| image_src | string | https URL | asset:<id> for image-bearing forms |
| imagery_tag | string | Subject/industry: steers library photos (covers, sections, picture slides) AND the topical palette. Omit = general; `education` = teaching. |
| min_font_pt | number | Binding type floor for prose (exhibit furniture has its own). Type grows to meet it; content that can't fit is an unbilled min_font_not_met naming the size needed. Typical: 12. |
| source_note | string | source / footnote line (per-form). |
| force_render | boolean | On completed_with_errors, pptx_url is null (broken slide). Set true to get it anyway. No cost/status effect. |
| image_prompt | string | generate an image when no image_src |
| replacements | array | String replacements on loaded code [{old, new}] (for mode=code with job_id) |
| variant_policy | string | Routed-variant maturity policy: production_safe = if the ROUTED variant is draft/beta, render the family's demo-safe sibling instead (warning names both). Never overrides an explicit variant=. Default best_semantic_match. |
| include_preview | string | Inline-preview PAYLOAD only (not execution). Default: default (768px). none omits the inline image and returns just the URLs — it does NOT change sync/async. Use `wait` to control execution. |
| quality_profile | string | Thresholds layout.presentation_ready is judged against (executive strictest). Measurement only — never blocks a render or changes cost. |
| allow_truncation | boolean | More items than the form holds blocks (it would drop your data); the response names the dropped count + a suggested_split. true renders the capacity subset (fidelity=verbatim_truncated). Default false. |
| form_description | string | |
| allow_fabrication | boolean | Brief mode only: a bare brief on a DATA form (kpi/funnel/comparison/…) returns would_fabricate, not billed, rather than INVENT numbers. Send typed fields for verbatim, or true to let the brief author them (fidelity=ai_completed). Default false. |
| allow_low_confidence | boolean | Brief routing only: by default a brief that doesn't match a form clearly returns status=needs_confirmation + candidates at cost:0 (no guessed render). Set true to render the top guess and bill it. Default false. |
| allow_variant_fallback | boolean | If the pinned variant is unknown, render the form's default variant (with a warning) instead of rejecting. Default false. |
{
"type": "object",
"properties": {
"code": {
"type": "string",
"description": "Python code defining build(prs). Canvas 13.33×7.5\", coords in inches. Pre-imported: Presentation, Inches, Pt, Emu, RGBColor, MSO_ANCHOR, PP_ALIGN. Helpers: add_text_box(slide, left, top, w, h, text, font_size=12, bold=False, color=None), add_box(slide, left, top, w, h, fill_color=None, line_color=None, corner_radius=0.05), add_icon, add_image (src = path or https://); theme_color(name) → RGBColor. add_widget(slide, name, x, y, w, h, params=|content=, theme=THEME) draws board-grade SSG widgets/charts (cards, waterfall, gantt, funnel…) — names via `browse_catalog(type=widgets)`. Use font_size=, not size=; use fill_color=, not fill=. When chrome is supplied, use `build(prs, slide)` — chrome is pre-rendered. Helper signatures: `browse_catalog(type=helpers)`."
},
"data": {
"type": "object",
"description": "family-specific payload — see the documented shapes"
},
"date": {
"type": "string",
"description": "date callout (per-form)."
},
"form": {
"type": "string",
"description": "the form menu pick (see description) — the routing field"
},
"mode": {
"enum": [
"safe",
"brief",
"code",
"status"
],
"type": "string",
"description": "Default: structured intent / brief. safe = validate-then-render in ONE call (renders + bills only if faithful; else an unbilled invalid report with the fix — recommended, no dry_run round-trip). code = python-pptx escape. status = poll."
},
"name": {
"type": "string"
},
"wait": {
"enum": [
"auto",
"true",
"false"
],
"type": "string",
"description": "AI-image slides block ~10-15s; `false` returns a job_id to poll, not block (mode=brief)."
},
"brief": {
"type": "string",
"description": "prose fallback / extra context for fills"
},
"notes": {
"type": "string",
"description": "Speaker notes for the presenter; never drawn on the slide."
},
"blocks": {
"type": "array",
"items": {
"type": "object"
},
"description": "list: [{\"label\",\"sub\",\"detail\":[str],\"emphasis\",\"icon\":lucide-name,\"metric\":{value,label}}]"
},
"detail": {
"enum": [
"compact",
"full"
],
"type": "string",
"description": "Response verbosity. Default `compact`: status, form/variant, fidelity (verbatim|mixed|ai_completed), warnings[]/errors[] (only when present), urls, cost. `full` adds a debug object (engine internals, verify events, latency buckets)."
},
"job_id": {
"type": "string",
"description": "Previous job ID (for mode=status, or mode=code patching)"
},
"metric": {
"type": "object"
},
"verify": {
"enum": [
"off",
"lint",
"lint+vlm",
"full"
],
"type": "string",
"description": "mode=code. Default `lint`: static geometry + content checks, no LLM. `lint+vlm` adds a VLM second look (~+3s); a blank render is then an unbilled error, not a billed warning. `off` skips checks."
},
"caution": {
"type": "string",
"description": "one-line risk / caveat callout (per-form)."
},
"context": {
"type": "string",
"description": "one-line subtitle/standfirst"
},
"dry_run": {
"type": "boolean",
"description": "Free pre-commit check (intent or mode=code), cost:0, no PPTX: status + warnings/errors, plus fidelity_forecast (verbatim|mixed|ai_completed|would_reject) and which fields bind vs get authored. Fix errors, re-call with dry_run=false to render."
},
"imagery": {
"enum": [
"photo",
"wash",
"off"
],
"type": "string",
"description": "Cover/section-divider imagery: photo (default — curated stock photo, half-bleed), wash (abstract color wash), off (plain panel, no photo — only when asked). Content slides are never photo-decorated."
},
"logo_id": {
"type": "string",
"description": "Optional brand logo (from upload_asset purpose=logo) drawn as chrome on content slides; covers/section breaks stay clean."
},
"styling": {
"enum": [
"topical",
"clean"
],
"type": "string",
"description": "Topical design on default themes (default on; the note names it): designed cover + a subject palette (from imagery_tag, or the brief). clean = neutral. Pins never take it."
},
"subject": {
"type": "string",
"description": "central entity for forms that have one — hub label, org root, section #, fork origin, media label (per-form)."
},
"variant": {
"type": "string",
"description": "pin a specific variant within the form (list them via browse_catalog). Unknown variant -> rejected (not billed) with the valid list; set allow_variant_fallback to render the family default instead."
},
"headline": {
"type": "string",
"description": "the assertion-style slide title"
},
"language": {
"enum": [
"bg",
"ca",
"cs",
"da",
"de",
"el",
"en",
"es",
"et",
"fi",
"fr",
"gl",
"hr",
"hu",
"id",
"is",
"it",
"ja",
"ko",
"lt",
"lv",
"nl",
"no",
"pl",
"pt",
"ro",
"ru",
"sk",
"sl",
"sr",
"sv",
"tr",
"uk",
"vi",
"zh"
],
"type": "string",
"description": "ISO 639-1 (default en): furniture labels and authored fills follow it."
},
"takeaway": {
"type": "string",
"description": "optional verdict band (per-form). Put the so-what in the headline; add only for a verdict the title can't carry — not every slide."
},
"theme_id": {
"type": "string",
"description": "Optional theme id from browse_catalog(type=themes). Omit for Default (slideforge_standard)."
},
"direction": {
"enum": [
"ltr",
"rtl"
],
"type": "string",
"description": "rtl typesets AND mirrors the slide right-to-left (Arabic/Hebrew). Never inferred — pass it."
},
"highlight": {
"type": "string",
"description": "one-line emphasis callout (per-form)."
},
"image_src": {
"type": "string",
"description": "https URL | asset:<id> for image-bearing forms"
},
"imagery_tag": {
"enum": [
"general",
"agriculture",
"construction",
"education",
"energy",
"finance",
"government",
"healthcare",
"logistics",
"manufacturing",
"retail",
"technology",
"travel"
],
"type": "string",
"description": "Subject/industry: steers library photos (covers, sections, picture slides) AND the topical palette. Omit = general; `education` = teaching."
},
"min_font_pt": {
"type": "number",
"maximum": 40,
"minimum": 6,
"description": "Binding type floor for prose (exhibit furniture has its own). Type grows to meet it; content that can't fit is an unbilled min_font_not_met naming the size needed. Typical: 12."
},
"source_note": {
"type": "string",
"description": "source / footnote line (per-form)."
},
"force_render": {
"type": "boolean",
"description": "On completed_with_errors, pptx_url is null (broken slide). Set true to get it anyway. No cost/status effect."
},
"image_prompt": {
"type": "string",
"description": "generate an image when no image_src"
},
"replacements": {
"type": "array",
"items": {
"type": "object",
"required": [
"old",
"new"
],
"properties": {
"new": {
"type": "string",
"description": "Replacement string"
},
"old": {
"type": "string",
"description": "Exact string to find"
}
}
},
"description": "String replacements on loaded code [{old, new}] (for mode=code with job_id)"
},
"variant_policy": {
"enum": [
"best_semantic_match",
"production_safe"
],
"type": "string",
"description": "Routed-variant maturity policy: production_safe = if the ROUTED variant is draft/beta, render the family's demo-safe sibling instead (warning names both). Never overrides an explicit variant=. Default best_semantic_match."
},
"include_preview": {
"enum": [
"none",
"small",
"default",
"full"
],
"type": "string",
"description": "Inline-preview PAYLOAD only (not execution). Default: default (768px). none omits the inline image and returns just the URLs — it does NOT change sync/async. Use `wait` to control execution."
},
"quality_profile": {
"enum": [
"executive",
"technical",
"appendix"
],
"type": "string",
"description": "Thresholds layout.presentation_ready is judged against (executive strictest). Measurement only — never blocks a render or changes cost."
},
"allow_truncation": {
"type": "boolean",
"description": "More items than the form holds blocks (it would drop your data); the response names the dropped count + a suggested_split. true renders the capacity subset (fidelity=verbatim_truncated). Default false."
},
"form_description": {
"type": "string"
},
"allow_fabrication": {
"type": "boolean",
"description": "Brief mode only: a bare brief on a DATA form (kpi/funnel/comparison/…) returns would_fabricate, not billed, rather than INVENT numbers. Send typed fields for verbatim, or true to let the brief author them (fidelity=ai_completed). Default false."
},
"allow_low_confidence": {
"type": "boolean",
"description": "Brief routing only: by default a brief that doesn't match a form clearly returns status=needs_confirmation + candidates at cost:0 (no guessed render). Set true to render the top guess and bill it. Default false."
},
"allow_variant_fallback": {
"type": "boolean",
"description": "If the pinned variant is unknown, render the form's default variant (with a warning) instead of rejecting. Default false."
}
}
}| detail | boolean | For action=status only: default false masks identity fields; true returns full email/user_id diagnostics for the authenticated user. |
| job_id | string | Job ID (for action=job, action=download_url and action=delete_job) |
| status | string | Filter — action=jobs: queued/generating/complete/failed; action=feedback_list: open/resolved |
| message | string | What went wrong or what you want, in the user's own words (for action=feedback). |
| asset_id | string | Image asset ID (for action=delete_asset). Logos are content-addressed/shared and are not deleted by this action. |
| category | string | Feedback category (action=feedback to file under it, action=feedback_list to filter by it). The first nine are slide-quality categories — pair them with job_id. |
| severity | string | For action=feedback: `bug` = it is broken, `quality` = it rendered but reads poorly, `suggestion` = a request. Defaults to suggestion, so file real defects explicitly or they are triaged as wishes. |
| include_preview | string | Preview (for action=job) |
| include_children | boolean | For action=jobs: include deck child slides (each carries parent_deck_id) so a deck's slides are discoverable by listing. Default false (parents only). Deck rows roll child cost up to the deck. |
{
"type": "object",
"required": [
"action"
],
"properties": {
"days": {
"type": "integer",
"description": "Lookback period (for action=usage, default 30)"
},
"slug": {
"type": "string",
"description": "Report slug (for action=reports — returns one report's full metadata; omit to list all)."
},
"limit": {
"type": "integer",
"description": "Max rows (action=jobs default 10; action=feedback_list default 50, max 100)"
},
"action": {
"enum": [
"status",
"usage",
"jobs",
"job",
"download_url",
"feedback",
"feedback_list",
"onboarding",
"brand_report",
"reports",
"security_status",
"delete_job",
"delete_asset"
],
"type": "string",
"description": "Operation (required). feedback → report a defect or request against a render; pass job_id so it is actionable, and ask the user before filing. feedback_list → read YOUR OWN filed reports back, with `status` and the `resolution` written when one was acted on: check it before working around a defect you reported earlier, because it may already be fixed. brand_report → the per-token fidelity report for one of your brand kits (pass theme_id). reports → list report types. delete_job is irreversible. delete_asset is irreversible for user-owned image assets."
},
"detail": {
"type": "boolean",
"description": "For action=status only: default false masks identity fields; true returns full email/user_id diagnostics for the authenticated user."
},
"job_id": {
"type": "string",
"description": "Job ID (for action=job, action=download_url and action=delete_job)"
},
"status": {
"type": "string",
"description": "Filter — action=jobs: queued/generating/complete/failed; action=feedback_list: open/resolved"
},
"message": {
"type": "string",
"description": "What went wrong or what you want, in the user's own words (for action=feedback)."
},
"asset_id": {
"type": "string",
"description": "Image asset ID (for action=delete_asset). Logos are content-addressed/shared and are not deleted by this action."
},
"category": {
"enum": [
"layout",
"typography",
"contrast",
"content",
"icons",
"images",
"theme",
"chrome",
"consistency",
"bug",
"feature_request",
"testimonial",
"general",
"other"
],
"type": "string",
"description": "Feedback category (action=feedback to file under it, action=feedback_list to filter by it). The first nine are slide-quality categories — pair them with job_id."
},
"severity": {
"enum": [
"bug",
"quality",
"suggestion"
],
"type": "string",
"description": "For action=feedback: `bug` = it is broken, `quality` = it rendered but reads poorly, `suggestion` = a request. Defaults to suggestion, so file real defects explicitly or they are triaged as wishes."
},
"include_preview": {
"enum": [
"none",
"small",
"default",
"full"
],
"type": "string",
"description": "Preview (for action=job)"
},
"include_children": {
"type": "boolean",
"description": "For action=jobs: include deck child slides (each carries parent_deck_id) so a deck's slides are discoverable by listing. Default false (parents only). Deck rows roll child cost up to the deck."
}
}
}| string |
| Target language (required) |
{
"type": "object",
"required": [
"target_language"
],
"properties": {
"name": {
"type": "string",
"description": "Job name"
},
"job_id": {
"type": "string",
"description": "Source: previous slide/deck job ID (preferred — no file transfer needed)"
},
"pptx_url": {
"type": "string",
"description": "Source: HTTPS URL to .pptx"
},
"pptx_base64": {
"type": "string",
"description": "Source: Base64-encoded .pptx (max ~10 MB)"
},
"concise_mode": {
"type": "boolean",
"description": "Prefer shorter translations for tight text boxes"
},
"include_notes": {
"type": "boolean",
"description": "Translate speaker notes (default false)"
},
"include_tables": {
"type": "boolean",
"description": "Translate table cells (default true)"
},
"include_preview": {
"enum": [
"none",
"small",
"default"
],
"type": "string",
"description": "Wait+embed preview (default=wait)"
},
"source_language": {
"type": "string",
"description": "Source language or 'auto' (default auto)"
},
"target_language": {
"enum": [
"en",
"de",
"fr",
"es",
"it",
"pt",
"nl",
"sv",
"da",
"no",
"fi",
"is",
"pl",
"cs",
"sk",
"hu",
"ro",
"hr",
"sl",
"et",
"lt",
"lv",
"ru",
"uk",
"bg",
"sr",
"tr",
"ca",
"gl",
"id",
"vi",
"el",
"zh",
"ja",
"ko"
],
"type": "string",
"description": "Target language (required)"
}
}
}| Asset type (required). brand = a .pptx/.potx corporate template imported as your brand kit (theme is the same thing under its old name). |
| quality | string | draft = Flux Schnell. balanced (default) = Gemini Flash Image. premium = GPT Image 2. Overridden by `model`. |
| filename | string | Original filename (for type detection) |
| position | string | Logo position: top-left / top-right / bottom-left / bottom-right |
| theme_id | string | For purpose=recreate: the brand kit or built-in theme to render the recreated slide in — your kit slug, `slug@version`, or a built-in id. Omit to keep the look of the source image. |
| theme_name | string | Name for extracted theme (purpose=theme) |
| target_language | string | Required for purpose=translate. Optional for purpose=pdf — chains pdf→pptx→translate in one call. |
{
"type": "object",
"required": [
"purpose"
],
"properties": {
"data": {
"type": "string",
"description": "Base64-encoded file content. Required for logo/image/theme/translate. Optional for pdf — omit to get a drop-zone (recommended for files >3MB)."
},
"size": {
"enum": [
"1024x1024",
"1792x1024",
"1024x1792"
],
"type": "string",
"description": "Image dimensions for generate_image (default 1024×1024)"
},
"model": {
"type": "string",
"description": "Explicit gateway model ID. Overrides `quality`."
},
"job_id": {
"type": "string",
"description": "For purpose=brand: keep the look a recreate rendered in — pass that recreate's job_id and its exact kit is saved as yours (no upload, no charge)."
},
"prompt": {
"type": "string",
"description": "Image description (required when purpose=generate_image)"
},
"purpose": {
"enum": [
"logo",
"image",
"theme",
"brand",
"generate_image",
"translate",
"pdf",
"recreate"
],
"type": "string",
"description": "Asset type (required). brand = a .pptx/.potx corporate template imported as your brand kit (theme is the same thing under its old name)."
},
"quality": {
"enum": [
"draft",
"balanced",
"premium"
],
"type": "string",
"description": "draft = Flux Schnell. balanced (default) = Gemini Flash Image. premium = GPT Image 2. Overridden by `model`."
},
"filename": {
"type": "string",
"description": "Original filename (for type detection)"
},
"position": {
"type": "string",
"description": "Logo position: top-left / top-right / bottom-left / bottom-right"
},
"theme_id": {
"type": "string",
"description": "For purpose=recreate: the brand kit or built-in theme to render the recreated slide in — your kit slug, `slug@version`, or a built-in id. Omit to keep the look of the source image."
},
"theme_name": {
"type": "string",
"description": "Name for extracted theme (purpose=theme)"
},
"target_language": {
"enum": [
"en",
"de",
"fr",
"es",
"it",
"pt",
"nl",
"sv",
"da",
"no",
"fi",
"is",
"pl",
"cs",
"sk",
"hu",
"ro",
"hr",
"sl",
"et",
"lt",
"lv",
"ru",
"uk",
"bg",
"sr",
"tr",
"ca",
"gl",
"id",
"vi",
"el",
"zh",
"ja",
"ko"
],
"type": "string",
"description": "Required for purpose=translate. Optional for purpose=pdf — chains pdf→pptx→translate in one call."
}
}
}