---
title: "Save Project"
method: POST
path: "/api/v1/whiteboard/save-project"
tags: ["whiteboard"]
---

# Save Project

`POST /api/v1/whiteboard/save-project`

## 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/whiteboard/save-project`
- Auth: none declared

下課存回專案：建立 type=whiteboard 的專案，每頁板書一張投影片
（image＝前端渲染的整頁 PNG、script＝該頁定稿逐字稿、visual_config.whiteboard＝元素結構資料），
之後就能在 /projects 用既有的備課/複盤流程接續。

## Headers

- `Authorization` string, nullable

## Request body

- SaveProjectRequest
  - `title` string, nullable
  - `started_at` integer, nullable
  - `pages` SavePage[], required
    - `index` integer, required
    - `started_at` integer, nullable
    - `ended_at` integer, nullable
    - `transcript` string[]
    - `elements` SavePageElement[]
      - `template` string
      - `headline` string
      - `items` string[]
      - `appends` array[]
        - string[]
      - `confidence` number
      - `source` string
      - `created_at` integer
    - `image_base64` string, nullable
  - `project_id` string, nullable

## Response `200`

Successful Response

- SaveProjectResponse
  - `project_id` string, required
  - `slide_count` integer, required

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