---
title: "作ったプロジェクトのテンプレートを差し替える"
method: PUT
path: "/api/v1/projects/{projectId}/template"
tags: ["projects"]
---

# 作ったプロジェクトのテンプレートを差し替える

`PUT /api/v1/projects/{projectId}/template`

## Request

- Base URL: `https://app.yukkurigen.com`
- URL: `https://app.yukkurigen.com/api/v1/projects/{projectId}/template`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

## Path parameters

- `projectId` string, required

## Request body

- object
  - `templateId` string, nullable, required: GET /agent/templates の id（組み込み・自分のもの）。null で外す

## Response `200`

差し替えた

- object
  - `projectId` string, required
  - `templateId` string, nullable
  - `source` 'system' | 'mine'
  - `layout` object: キャラの枠・字幕・素材の枠の位置（画面に対する %）
    - `characters` object[], required
      - `slot` string, required
      - `label` string
      - `character` string
      - `x` number, required
      - `y` number, required
      - `width` number, required
      - `height` number, required
    - `subtitle` object, nullable: 画面に対する %（x/y は左上）
      - `x` number
      - `y` number
      - `width` number
      - `height` number
    - `material` object, nullable: 行ごとの素材画像（materialImageUrl）が出る枠
      - `x` number
      - `y` number
      - `width` number
      - `height` number
  - `note` string

## Other responses

- `400`: templateId が無い（invalid_request）
- `401`: 未認証
- `403`: 権限不足（projects:write）・他人のプロジェクト（forbidden）
- `404`: プロジェクト・テンプレートが無い（not_found / template_not_found）

## Changes

- **2026-10-20** `ba5f36b016da`: 20 warning, 12 info
  - added the new `already_subscribed` enum value to the `code` response property for the response status `400`
  - added the new `already_subscribed` enum value to the `code` response property for the response status `401`
  - added the new `already_subscribed` enum value to the `code` response property for the response status `403`
  - added the new `already_subscribed` enum value to the `code` response property for the response status `404`
  - …28 more

[Operation history](https://skmtc.dev/yukkurigen/apis/yukkurigen-ai-operated-api/changes/api/v1/projects/:projectId/template/put.md)

---

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