> ## 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.

# App-Versionsverlauf

> Alle veröffentlichten Versionen einer App auflisten, neueste zuerst.

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

Authentifizierung: optional. Mit API-Schlüssel sehen Sie ggf. Apps, die eine angemeldete Ansicht erfordern.

Alle veröffentlichten Versionen, neueste zuerst. Detail- und Run-Aufrufe verwenden standardmäßig die neueste Version. Übergeben Sie `version`, um ein historisches Release festzulegen.

Zurückgezogene (yanked) Versionen bleiben in der Historie und werden markiert. Sie werden nicht mehr als neueste aufgelöst und lehnen neue Runs ab, bestehende Ergebnisdaten bleiben aber lesbar.

## Anfrage

### Pfadparameter

<ParamField path="app_id" type="string" required>
  App-Referenz: `app_<hex>` oder `<namespace>/<app_name>`.
</ParamField>

### Beispielanfrage

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

## Antwort

### 200 Erfolg

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

Payload ist in `data` gewrappt. Felder:

<ResponseField name="items" type="array" required>
  Versionen, neueste zuerst.

  <Expandable title="item">
    <ResponseField name="version" type="string" required>
      Semantischer Versionsstring.
    </ResponseField>

    <ResponseField name="yanked" type="boolean" required>
      Ob die Version zurückgezogen (yanked) wurde.
    </ResponseField>

    <ResponseField name="created_at" type="string" required>
      Veröffentlichungszeit, ISO 8601.
    </ResponseField>

    <ResponseField name="build_id" type="string">
      Source Build id, falls verfügbar.
    </ResponseField>
  </Expandable>
</ResponseField>

### Fehler

| HTTP | `code`          | `category`  | Beschreibung                                                         |
| ---- | --------------- | ----------- | -------------------------------------------------------------------- |
| 401  | `unauthorized`  | `forbidden` | Fehlender oder ungültiger API-Schlüssel.                             |
| 404  | `app-not-found` | `not_found` | App existiert nicht oder ist für die aktuelle Credential unsichtbar. |

Fehlerantworten nutzen `{"error": {code, category, message, retryable}}`. Siehe <a href="/docs/de/datahub/api/reference/introduction#errors">Fehler</a>.

## Client-Bibliotheken

Die Python- und JavaScript-SDKs wrappen diesen Endpoint noch nicht. REST direkt aufrufen.