---
title: "Public Deepen Activity"
method: POST
path: "/api/v1/public/activity/deepen"
tags: ["public-api"]
---

# Public Deepen Activity

`POST /api/v1/public/activity/deepen`

## 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/public/activity/deepen`
- Auth: none declared

為一個**已確認**的 blueprint 裡的某個活動補 7 個教學深度欄位。

硬性前置條件：blueprint 必須透過 /course-blueprint/confirm 確認過（status=confirmed）。
未確認會直接 409。

context（course_title / audience / objectives）自動從 blueprint 取。

同步呼叫，3-6 秒回傳。

## Headers

- `Authorization` string, nullable
- `X-API-Key` string, nullable

## Request body

- PublicDeepenActivityRequest
  - `blueprint_id` string, required: 已確認的 blueprint_id（由 /course-experience/generate + /course-blueprint/confirm 產生）
  - `activity_index` integer, required: blueprint.activities 陣列中要深化的活動索引（0-based）
  - `language` 'zh-TW' | 'zh-CN' | 'en' | 'ja'

## Response `200`

Successful Response

- PublicDeepenActivityResponse
  - `prerequisite` string, required: 學員參與此活動前需具備的前置狀態
  - `transition_trigger` string, required: 觸發進入下一個活動的信號
  - `failure_signals` string[], required: 活動失敗的具體可觀察徵兆（3-5 條）
  - `design_rationale` string, required: 為何在此安排此活動的理由（引用 context）
  - `bloom_level` 'remember' | 'understand' | 'apply' | 'analyze' | 'evaluate' | 'create', required
  - `gagne_event` integer, required: Gagné 九大教學事件（1-9）
  - `success_criteria` string, required: 活動達成教學目標的可驗證事實
  - `summary` string, required
  - `next_suggestion` string, 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)