# General Translation Platform: Получить осиротевшие файлы
URL: https://generaltranslation.com/ru/docs/platform/openapi/reference/files/orphaned-files.mdx
---

title: Получить осиротевшие файлы
description: Найдите файлы General Translation, которые больше не связаны с текущими исходными файлами. Справочник API для метода «Получить осиротевшие файлы».

method: POST
---

Возвращает файлы в ветке, идентификаторы которых отсутствуют в предоставленном вами списке идентификаторов текущих файлов. Используется для обнаружения файлов, которые были локально перемещены, переименованы или удалены.

## Обзор [#overview]

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

**Разрешение** `project:files:read` · **Лимит запросов** Средний (120/мин)

Определяйте устаревшие файлы перед сверкой ветки. Чтобы затем переместить или переименовать их, используйте [Переместить файлы](/docs/platform/openapi/reference/files/move-files).

## Как это работает [#how-it-works]

* Файлы из HEAD ветки сравниваются с переданными вами `fileIds`.
* Любой файл в ветке, чей `fileId` отсутствует в этом списке, возвращается как осиротевший.
* `branchId` должен принадлежать проекту, иначе запрос вернёт `404`.
* Пустой список `fileIds` помечает все файлы в ветке как осиротевшие.

## Запрос [#request]

### Заголовки

| Заголовок         | Описание                                                     | Обязательный |
| ----------------- | ------------------------------------------------------------ | ------------ |
| `x-gt-api-key`    | API-ключ проекта или Organization.                           | Да           |
| `x-gt-project-id` | ID проекта. Обязателен при использовании ключа Organization. | Нет          |

### Тело

**Тип содержимого** `application/json`

| Поле       | Описание                                                                                                            | Тип        | Необязательно | По умолчанию |
| ---------- | ------------------------------------------------------------------------------------------------------------------- | ---------- | ------------- | ------------ |
| `branchId` | Ветка для проверки; обязательное поле.                                                                              | `string`   | Нет           | —            |
| `fileIds`  | Текущие идентификаторы файлов, которые нужно сохранить. Файлы, отсутствующие в этом списке, считаются осиротевшими. | `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..."]
  }'
```