---
title: "テンプレートの位置関係を直す（自分のものだけ）"
method: PATCH
path: "/api/v1/agent/templates/{templateId}/layout"
tags: ["agent"]
---

# テンプレートの位置関係を直す（自分のものだけ）

`PATCH /api/v1/agent/templates/{templateId}/layout`

## Request

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

## Path parameters

- `templateId` string, required

## Request body

- object
  - `aspect` '16:9' | '9:16': 直す配置。16:9=横長（既定）/ 9:16=縦型（shorts・tiktok）
  - `characters` object[]
    - `slot` string, required
    - `x` number
    - `y` number
    - `width` number
    - `height` number
  - `subtitle` object: 画面に対する %（x/y は左上）
    - `x` number
    - `y` number
    - `width` number
    - `height` number
  - `material` object: 画面に対する %（x/y は左上）
    - `x` number
    - `y` number
    - `width` number
    - `height` number
  - `keepCharactersInPlace` boolean: true: 素材・強調テロップが出ていてもキャラを縮めて外側へ寄せない（全画面素材と card 行だけの動画向け）。false: 既定動作に戻す。

## Response `200`

直した

- object
  - `templateId` string, required
  - `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
    - `keepCharactersInPlace` boolean: true: 素材が出ていてもキャラを定位置に固定。省略時は既定動作（素材のある行でキャラが外側へ少し寄る）。
  - `note` string

## Other responses

- `400`: 直す項目が無い・値が範囲外（invalid_layout）・無い枠（unknown_slot）・組み込み（system_template）
- `401`: 未認証
- `403`: 権限不足（projects:write）
- `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/:templateId/layout/patch.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)