---
title: "テンプレートを複製する（位置を直す前に）"
method: POST
path: "/api/v1/agent/templates/copy"
tags: ["agent"]
---

# テンプレートを複製する（位置を直す前に）

`POST /api/v1/agent/templates/copy`

## Request

- Base URL: `https://app.yukkurigen.com`
- URL: `https://app.yukkurigen.com/api/v1/agent/templates/copy`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

## Request body

- object
  - `templateId` string, required: 複製元（GET /agent/templates の id）
  - `name` string

## Response `201`

複製した

- object
  - `templateId` string, required
  - `name` string
  - `basedOn` string, nullable
  - `layout` object, required: キャラの枠・字幕・素材の枠の位置（画面に対する %）
    - `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
  - `portraitLayout` object: 縦型（9:16）の配置。無いテンプレートでは項目ごと無い
    - `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
  - `nextStep` string

## Other responses

- `400`: templateId が無い（code: invalid_request）
- `401`: 未認証
- `403`: 権限不足（projects:write / insufficient_scope）・複製できないテンプレート（forbidden）
- `404`: テンプレートが無い（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/agent/templates/copy/post.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)