# General Translation Platform: Ottieni i file orfani
URL: https://generaltranslation.com/it/docs/platform/openapi/reference/files/orphaned-files.mdx
---

title: Ottieni i file orfani
description: Trova i file di General Translation che non sono più collegati ai file sorgente correnti. Riferimento API per l'operazione Ottieni i file orfani.

method: POST
---

Restituisce i file in un branch i cui ID non compaiono nell'elenco degli ID dei file correnti che fornisci. Serve a rilevare i file che sono stati spostati, rinominati o eliminati localmente.

## Panoramica [#overview]

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

**Permesso** `project:files:read` · **Limite di frequenza** Medio (120/min)

Rileva i file obsoleti prima di eseguire la riconciliazione di un branch. Per spostarli o rinominarli in seguito, usa [Sposta file](/docs/platform/openapi/reference/files/move-files).

## Come funziona [#how-it-works]

* I file head del branch vengono confrontati con i `fileIds` inviati.
* Qualsiasi file del branch il cui `fileId` non compare in quell'elenco viene restituito come orfano.
* Il `branchId` deve appartenere al Project, altrimenti la richiesta restituisce `404`.
* Un elenco `fileIds` vuoto contrassegna come orfano ogni file del branch.

## Richiesta [#request]

### Header

| Header            | Descrizione                                                                 | Obbligatorio |
| ----------------- | --------------------------------------------------------------------------- | ------------ |
| `x-gt-api-key`    | Chiave API del progetto o dell'organizzazione.                          | Sì           |
| `x-gt-project-id` | ID progetto. Obbligatorio quando si usa una chiave dell'organizzazione. | No           |

### Corpo

**Tipo di contenuto** `application/json`

| Campo      | Descrizione                                                                         | Tipo       | Facoltativo | Predefinito |
| ---------- | ----------------------------------------------------------------------------------- | ---------- | ----------- | ----------- |
| `branchId` | branch da esaminare; obbligatorio.                                                  | `string`   | No          | —           |
| `fileIds`  | ID dei file correnti da mantenere. I file non inclusi in questo elenco sono orfani. | `string[]` | Sì          | `[]`        |

## Risposta [#response]

**Stato** `200 OK`

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

## Errori [#errors]

| Stato | Causa                                                   |
| ----- | ------------------------------------------------------- |
| `400` | Corpo della richiesta non valido o `branchId` mancante. |
| `401` | chiave API mancante o non valida.                       |
| `403` | La chiave API non dispone di `project:files:read`.      |
| `404` | Branch non trovato.                                     |
| `429` | Limite di richieste superato.                           |

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