---
title: "Fill"
method: POST
path: "/api/v1/template/fill"
tags: ["template"]
---

# Fill

`POST /api/v1/template/fill`

## Request

- Base URL: `https://api.slidemaster.tw` (the document declares no server; this is the origin it was published from)
- URL: `https://api.slidemaster.tw/api/v1/template/fill`
- Auth: none declared

Fill template with caller-supplied fill plan, return PPTX download URL.

## Headers

- `Authorization` string, nullable

## Request body

- FillRequest
  - `template_id` string, required
  - `fill_plan` PagePlan[], required
    - `outline_page` integer, required
    - `template_slide` integer, required
    - `mappings` SlotMapping[], required
      - `slot_name` string, required
      - `text` string, required
  - `typography` object, nullable
  - `text_fit_policy` object, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/slidemaster/apis/slidemaster-ai-api.md) · [All operations](https://skmtc.dev/slidemaster/apis/slidemaster-ai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/slidemaster/apis/slidemaster-ai-api/revisions/a964c005977e?raw)