> ## 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 を改名

> 版を出さず進行中実行に影響なく App 名（ルーティング別名）を変更。

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

認証：APIキー必須（`Authorization: Bearer <API Key>`）。App 作者のみ。他者は `404`。

改名は完全に開いている — Release 0 件に限らない。App 名はルーティング別名: 改名は版を公開せず、実行やデータセットを壊さない。安定 `app_id` は不変。

壊れた呼び出し側参照は開発者責任: 改名後の古い `owner/old-name` 参照（MCP 固定、SDK、REST、詳細 URL）はリダイレクトなしで明確なな `404`。履歴の実行とデータセットは `app_id` で辿れる。

検証は識別子作成と同じ: 命名規則 → 予約語 → 新名 ≠ 現名。他者の名前との衝突は `409`。

## リクエスト

### パスパラメータ

<ParamField path="app_id" type="string" required>
  App reference.
</ParamField>

### リクエスト body

<ParamField body="new_app_name" type="string" required>
  —
</ParamField>

### リクエスト例

```bash theme={null}
curl -X POST \
  -H "Authorization: Bearer $OCTOPARSE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"app_name": "review-lookup"}' \
  "https://api-datahub.octoparse.com/v1/data-apps/carol/reviews-query/rename"
```

## レスポンス

### 200 成功

```json theme={null}
{
  "data": {
    "app_id": "app_6dfe4e839ccf",
    "namespace": "carol",
    "app_name": "review-lookup",
    "previous_app_name": "reviews-query"
  }
}
```

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

<ResponseField name="app_id" type="string" required>
  安定 App id — 不変。
</ResponseField>

<ResponseField name="app_name" type="string" required>
  New name.
</ResponseField>

<ResponseField name="namespace" type="string">
  発行者ユーザー名。
</ResponseField>

### エラー

| HTTP | `code`              | `category`      | Description                                    |
| ---- | ------------------- | --------------- | ---------------------------------------------- |
| 401  | `unauthorized`      | `forbidden`     | API キー欠落または無効。                                 |
| 400  | `invalid-app-name`  | `invalid_input` | Name fails naming rules or is a reserved word. |
| 409  | `app-name-reserved` | `forbidden`     | 他者の履歴バインドが名前を保持（ユーザー名移管後 30 日凍結）。              |
| 409  | `app-name-taken`    | `invalid_input` | この名前の App を既に持っている。                            |

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

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

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