> ## 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 バージョン履歴

> 公開済みバージョン一覧。新しい順。

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

認証：任意。API キーがあればログイン必須ビューの App も見える場合があります。

公開済み全バージョン。新しい順。詳細・実行は既定で最新。`version` で過去 Release 固定。

yank 済みも履歴に残りフラグ付き。latest 解決対象外で新規実行拒否。既存結果データは読める。

## リクエスト

### パスパラメータ

<ParamField path="app_id" type="string" required>
  App 参照: `app_<hex>` または `<namespace>/<app_name>`。
</ParamField>

### リクエスト例

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

## レスポンス

### 200 成功

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

ペイロードは `data` に包まれます。フィールド:

<ResponseField name="items" type="array" required>
  バージョン一覧。新しい順。

  <Expandable title="item">
    <ResponseField name="version" type="string" required>
      セマンティックバージョン文字列。
    </ResponseField>

    <ResponseField name="yanked" type="boolean" required>
      バージョンが yank 済みか。
    </ResponseField>

    <ResponseField name="created_at" type="string" required>
      公開時刻（ISO 8601）。
    </ResponseField>

    <ResponseField name="build_id" type="string">
      元 Build id（ある場合）。
    </ResponseField>
  </Expandable>
</ResponseField>

### エラー

| HTTP | `code`          | `category`  | Description     |
| ---- | --------------- | ----------- | --------------- |
| 401  | `unauthorized`  | `forbidden` | API キー欠落または無効。  |
| 404  | `app-not-found` | `not_found` | App が存在しないか不可視。 |

エラー応答は `{"error": {code, category, message, retryable}}` です。<a href="/docs/jp/datahub/api/reference/introduction#errors">エラー</a> を参照。

## クライアントライブラリ

Python / JavaScript SDK はまだこのエンドポイントをラップしていません。REST を直接呼び出してください。