# General Translation Platform: Obtener archivos huérfanos
URL: https://generaltranslation.com/es/docs/platform/openapi/reference/files/orphaned-files.mdx
---

title: Obtener archivos huérfanos
description: Encuentra archivos de General Translation que ya no están conectados a los archivos fuente actuales. Referencia de la API para Obtener archivos huérfanos.

method: POST
---

Devuelve los archivos de una rama cuyos ID de archivo no figuran en la lista de ID de archivo actuales que proporcionas. Se usa para detectar archivos movidos, renombrados o eliminados localmente.

## Descripción general [#overview]

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

**Permiso** `project:files:read` · **Límite de solicitudes** Medio (120/min)

Detecta archivos obsoletos antes de reconciliar una rama. Después, para moverlos o cambiarles el nombre, usa [Mover archivos](/docs/platform/openapi/reference/files/move-files).

## Cómo funciona [#how-it-works]

* Se comparan los archivos de la cabecera de la rama con los `fileIds` que envías.
* Cualquier archivo de la rama cuyo `fileId` no esté en esa lista se devuelve marcado como huérfano.
* El `branchId` debe pertenecer al proyecto; de lo contrario, la solicitud devuelve `404`.
* Una lista vacía de `fileIds` marca como huérfanos todos los archivos de la rama.

## Solicitud [#request]

### Cabeceras

| Cabecera          | Descripción                                                           | Obligatorio |
| ----------------- | --------------------------------------------------------------------- | ----------- |
| `x-gt-api-key`    | API key del proyecto o de la Organization.                            | Sí          |
| `x-gt-project-id` | ID del proyecto. Obligatorio cuando se usa una clave de Organization. | No          |

### Cuerpo

**Tipo de contenido** `application/json`

| Campo      | Descripción                                                                                                    | Tipo       | Opcional | Predeterminado |
| ---------- | -------------------------------------------------------------------------------------------------------------- | ---------- | -------- | -------------- |
| `branchId` | Rama que se debe inspeccionar; obligatorio.                                                                    | `string`   | No       | —              |
| `fileIds`  | IDs de los archivos actuales que se deben conservar. Los archivos que no estén en esta lista quedan huérfanos. | `string[]` | Sí       | `[]`           |

## Respuesta [#response]

**Estado** `200 OK`

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

## Errores [#errors]

| Estado | Causa                                                |
| ------ | ---------------------------------------------------- |
| `400`  | Cuerpo de la solicitud no válido o falta `branchId`. |
| `401`  | Falta la API key o no es válida.                     |
| `403`  | La API key no tiene `project:files:read`.            |
| `404`  | No se encontró la rama.                              |
| `429`  | Se superó el límite de solicitudes.                  |

## Ejemplo [#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..."]
  }'
```