# General Translation Platform: Récupérer les fichiers orphelins
URL: https://generaltranslation.com/fr/docs/platform/openapi/reference/files/orphaned-files.mdx
---

title: Récupérer les fichiers orphelins
description: Trouvez les fichiers General Translation qui ne sont plus liés aux fichiers source actuels. Référence de l’API pour récupérer les fichiers orphelins.

method: POST
---

Retourne les fichiers d’une branche dont les ID ne figurent pas dans la liste des ID de fichiers actuels que vous fournissez. Cette méthode permet de détecter les fichiers qui ont été déplacés, renommés ou supprimés localement.

## Vue d’ensemble [#overview]

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

**Autorisation** `project:files:read` · **Limite de taux** Moyenne (120/min)

Détectez les fichiers obsolètes avant de réconcilier une branche. Pour ensuite les déplacer ou les renommer, utilisez [Déplacer des fichiers](/docs/platform/openapi/reference/files/move-files).

## Comment ça fonctionne [#how-it-works]

* Les fichiers à la tête de la branche sont comparés aux `fileIds` que vous envoyez.
* Tout fichier de la branche dont le `fileId` ne figure pas dans cette liste est renvoyé comme orphelin.
* Le `branchId` doit appartenir au projet, sinon la requête renvoie `404`.
* Une liste `fileIds` vide marque tous les fichiers de la branche comme orphelins.

## Requête [#request]

### En-têtes

| En-tête           | Description                                                               | Obligatoire |
| ----------------- | ------------------------------------------------------------------------- | ----------- |
| `x-gt-api-key`    | Clé API du projet ou de l’organisation.                                   | Oui         |
| `x-gt-project-id` | ID du projet. Obligatoire lors de l’utilisation d’une clé d’organisation. | Non         |

### Corps

**Type de contenu** `application/json`

| Champ      | Description                                                                                             | Type       | Facultatif | Valeur par défaut |
| ---------- | ------------------------------------------------------------------------------------------------------- | ---------- | ---------- | ----------------- |
| `branchId` | Branche à examiner ; obligatoire.                                                                       | `string`   | Non        | —                 |
| `fileIds`  | IDs des fichiers actuels à conserver. Les fichiers qui ne figurent pas dans cette liste sont orphelins. | `string[]` | Oui        | `[]`              |

## Réponse [#response]

**État** `200 OK`

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

## Erreurs [#errors]

| État  | Cause                                                             |
| ----- | ----------------------------------------------------------------- |
| `400` | Corps de requête invalide ou `branchId` manquant.                 |
| `401` | Clé API manquante ou invalide.                                    |
| `403` | La clé API ne dispose pas de l’autorisation `project:files:read`. |
| `404` | Branche introuvable.                                              |
| `429` | Limite de requêtes dépassée.                                      |

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