---
title: "Api Save Design Recipe"
method: POST
path: "/api/v1/knowledge/recipes"
---

# Api Save Design Recipe

`POST /api/v1/knowledge/recipes`

## Request

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

## Headers

- `authorization` string, nullable

## Request body

- DesignRecipeRequest
  - `title` string, required
  - `intent` string, required
  - `technique_summary` string, required
  - `instructions` string, required
  - `example` string
  - `example_format` 'text' | 'markdown' | 'sandbox_html'
  - `constraints` string[]
  - `tags` string[]
  - `language` string
  - `motion` 'none' | 'optional' | 'required'
  - `accessibility` string[]
  - `novel_id` integer, nullable
  - `chapter_ids` integer[]

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/surl/apis/humanread.md) · [All operations](https://skmtc.dev/surl/apis/humanread/llms.txt) · [OpenAPI document](https://skmtc.dev/surl/apis/humanread/revisions/0a54f33f41df?raw)