# General Translation Platform: ファイルを移動
URL: https://generaltranslation.com/ja/docs/platform/openapi/reference/files/move-files.mdx
---

title: ファイルを移動
description: General Translation プロジェクト内のファイルを移動または名前変更します。ファイルの移動に関する API リファレンスです。

method: POST
---

各ソースファイルとその翻訳を新しいファイル ID と名前で複製することで、ファイルを移動または名前変更します。移動するファイルごとに 1 つのエントリを送信してください。

## 概要 [#overview]

```http
POST https://api2.gtx.dev/v2/project/files/moves
```

**権限** `project:files:write` · **レート制限** 中 (120/分) 

名前が変更された、または移動されたソースファイルを、翻訳を失うことなく反映します。古い状態になったファイルを検出するには、[孤立したファイルを取得](/docs/platform/openapi/reference/files/orphaned-files)を使用します。

## 仕組み [#how-it-works]

* 各移動では、既存のソースファイルとその翻訳が `newFileId` および `newFileName` に複製され、翻訳は保持されます。
* `branchId` が指定されていない場合はデフォルトブランチが使用されます。指定された `branchId` は プロジェクト に属している必要があり、そうでない場合、リクエストは `404` を返します。
* `moves` 配列が空の場合は、エラーにならず、空の結果セットが返されます。
* レスポンスには、各移動の結果と、移動の合計数、成功数、失敗数の集計が含まれます。

## リクエスト [#request]

### ヘッダー

| ヘッダー              | 説明                                      | 必須  |
| ----------------- | --------------------------------------- | --- |
| `x-gt-api-key`    | プロジェクトまたは Organization の APIキー。         | はい  |
| `x-gt-project-id` | プロジェクト ID。Organization のキーを使用する場合に必要です。 | いいえ |

### 本文

**コンテンツタイプ** `application/json`

| フィールド             | 説明              | 型          | 任意  | デフォルト     |
| ----------------- | --------------- | ---------- | --- | --------- |
| [`moves`](#moves) | 処理対象のファイル移動の配列。 | `object[]` | いいえ | —         |
| `branchId`        | ファイルが存在するブランチ。  | `string`   | はい  | デフォルトブランチ |

#### `moves` [#moves]

**型** `object[]`

各要素は、1 件のファイル移動を表します。

| フィールド         | 説明                      | 型        | 任意  | デフォルト |
| ------------- | ----------------------- | -------- | --- | ----- |
| `oldFileId`   | 現在のファイル識別子。空文字は指定できません。 | `string` | いいえ | —     |
| `newFileId`   | 新しいファイル識別子。空文字は指定できません。 | `string` | いいえ | —     |
| `newFileName` | 新しいファイル名。空文字は指定できません。   | `string` | いいえ | —     |

## レスポンス [#response]

**ステータス** `200 OK`

```json title="Response"
{
  "results": [
    {
      "oldFileId": "file_old...",
      "newFileId": "file_new...",
      "success": true,
      "newSourceFileId": "sf_...",
      "clonedTranslationsCount": 2
    }
  ],
  "summary": {
    "total": 1,
    "succeeded": 1,
    "failed": 0
  }
}
```

## エラー [#errors]

| ステータス | 原因                                     |
| ----- | -------------------------------------- |
| `400` | リクエスト本文が無効です。                          |
| `401` | APIキーがないか無効です。                         |
| `403` | APIキーに `project:files:write` 権限がありません。 |
| `404` | 指定された `branchId` がプロジェクト内に見つかりません。     |
| `429` | レート制限を超過しました。                          |

## 例 [#example]

```bash
curl -X POST https://api2.gtx.dev/v2/project/files/moves \
  -H "x-gt-api-key: gtx-api-..." \
  -H "Content-Type: application/json" \
  -d '{
    "moves": [
      {
        "oldFileId": "file_old...",
        "newFileId": "file_new...",
        "newFileName": "en/renamed.json"
      }
    ]
  }'
```