> ## Documentation Index
> Fetch the complete documentation index at: https://www.octoparse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Historique des versions

> Liste toutes les versions publiées d’une app, de la plus récente à la plus ancienne.

**`GET`** `https://api-datahub.octoparse.com/v1/data-apps/{app_id}/versions`

Authentification : facultative. Avec une clé API vous pouvez voir des apps qui exigent une vue connectée.

Toutes les versions publiées, de la plus récente à la plus ancienne. Les appels de détail et d’exécution utilisent par défaut la dernière version. Passez `version` pour épingler un release historique.

Les versions yankées restent dans l’historique et sont marquées. Elles ne sont plus résolues comme latest et rejettent les nouvelles exécutions, mais les données de résultat existantes restent lisibles.

## Requête

### Paramètres de chemin

<ParamField path="app_id" type="string" required>
  Référence d’app : `app_<hex>` ou `<namespace>/<app_name>`.
</ParamField>

### Exemple de requête

```bash theme={null}
curl   -H "Authorization: Bearer $OCTOPARSE_API_KEY"   "https://api-datahub.octoparse.com/v1/data-apps/carol/probe-b/versions"
```

## Réponse

### 200 succès

```json theme={null}
{
  "data": {
    "items": [
      {
        "version": "0.2.0",
        "yanked": false,
        "created_at": "2026-09-01T08:00:00+00:00",
        "build_id": "bld_123"
      }
    ]
  }
}
```

La charge utile est enveloppée dans `data`. Champs :

<ResponseField name="items" type="array" required>
  Versions, de la plus récente à la plus ancienne.

  <Expandable title="item">
    <ResponseField name="version" type="string" required>
      Chaîne de version sémantique.
    </ResponseField>

    <ResponseField name="yanked" type="boolean" required>
      Indique si la version a été yankée.
    </ResponseField>

    <ResponseField name="created_at" type="string" required>
      Heure de publication, ISO 8601.
    </ResponseField>

    <ResponseField name="build_id" type="string">
      Identifiant du Build source, s’il est disponible.
    </ResponseField>
  </Expandable>
</ResponseField>

### Erreurs

| HTTP | `code`          | `category`  | Description                                                    |
| ---- | --------------- | ----------- | -------------------------------------------------------------- |
| 401  | `unauthorized`  | `forbidden` | Clé API manquante ou invalide.                                 |
| 404  | `app-not-found` | `not_found` | L’app n’existe pas ou est invisible pour l’identifiant actuel. |

Les réponses d’erreur utilisent `{"error": {code, category, message, retryable}}`. Voir <a href="/docs/fr/datahub/api/reference/introduction#errors">Erreurs</a>.

## Bibliothèques clientes

Les SDK Python et JavaScript n’encapsulent pas encore cet endpoint. Appelez REST directement.