---
title: "プロジェクトの設定を更新する"
method: PUT
path: "/api/v1/projects/{projectId}"
tags: ["projects"]
---

# プロジェクトの設定を更新する

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

## Request

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

## Path parameters

- `projectId` string, required

## Request body

- object
  - `title` string
  - `description` string
  - `thumbnailText` string
  - `template_id` string
  - `channelId` string, nullable
  - `background_image_url` string
  - `bgm_path` string
  - `bgm_volume` number
  - `target_duration_sec` number
  - `status` 'draft' | 'rendering' | 'completed' | 'error'
  - `platform` string
  - `fontSize` number
  - `titleFontSize` number
  - `voice_playback_rate` number
  - `voice_pitch_scale` number
  - `material_image_filter` string[]

## Response `200`

更新成功

- object
  - `success` boolean
  - `projectId` string

## Other responses

- `401`: 未認証（code: unauthenticated）
- `403`: 権限不足（projects:read / code: insufficient_scope）
- `404`: プロジェクトが見つからない（code: not_found）

---

[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)