# General Translation Platform: 孤立したファイルを取得
URL: https://generaltranslation.com/ja/docs/platform/openapi/reference/files/orphaned-files.mdx
---

title: 孤立したファイルを取得
description: 現在のソースファイルに関連付けられていない General Translation のファイルを見つけます。「孤立したファイルを取得」の API リファレンス。

method: POST
---

指定した現在のファイル ID 一覧に含まれていないファイル ID を持つ、ブランチ上のファイルを返します。ローカルで移動、名前変更、または削除されたファイルを検出するために使用します。

## 概要 [#overview]

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

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

ブランチを整合する前に、古くなったファイルを検出します。続けてそれらを移動または名前変更するには、[ファイルを移動](/docs/platform/openapi/reference/files/move-files) を使用します。

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

* ブランチの先頭ファイルが、送信した `fileIds` と照合されます。
* ブランチ上のファイルのうち、`fileId` がその一覧に含まれていないものは、孤立として返されます。
* `branchId` は Project に属している必要があり、そうでない場合、リクエストは `404` を返します。
* `fileIds` の一覧が空の場合、ブランチ上のすべてのファイルが孤立として扱われます。

## リクエスト [#request]

### ヘッダー

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

### 本文

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

| フィールド      | 説明                                             | 型          | 任意  | デフォルト |
| ---------- | ---------------------------------------------- | ---------- | --- | ----- |
| `branchId` | 確認するbranch。必須です。                               | `string`   | いいえ | —     |
| `fileIds`  | 保持する現在のファイル ID。この一覧に含まれないファイルは 孤立 になります。 | `string[]` | はい  | `[]`  |

## レスポンス [#response]

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

```json title="Response"
{
  "orphanedFiles": [
    {
      "fileId": "file_...",
      "versionId": "ver_...",
      "fileName": "en/removed.json"
    }
  ]
}
```

## エラー [#errors]

| ステータス | 原因                                     |
| ----- | -------------------------------------- |
| `400` | 無効なリクエストボディ、または `branchId` がありません。     |
| `401` | API キーがないか、無効です。                       |
| `403` | API キーに `project:files:read` 権限がありません。 |
| `404` | ブランチが見つかりません。                          |
| `429` | レート制限を超過しました。                          |

## 例 [#example]

```bash
curl -X POST https://api2.gtx.dev/v2/project/files/orphaned \
  -H "x-gt-api-key: gtx-api-..." \
  -H "Content-Type: application/json" \
  -d '{
    "branchId": "br_...",
    "fileIds": ["file_a...", "file_b..."]
  }'
```