ストアを論理削除します。ストアデータは保持されますがアクセスできなくなります。この操作はストアの owner のみが実行できます。
POST /v1/actions/store/delete-store
認証: API Key(owner ロールが必要)
リクエストボディ
| フィールド | 型 | 必須 | 説明 |
|---|
id | string | はい | 削除するストア ID(Short ID 形式 STO_xxx) |
リクエスト例
const { store } = await client.stores.delete({
id: "STO_2aUyqjCzEIiEcYMKj7TZtw",
});
console.log(store.deletedAt); // => "2026-01-15T12:00:00.000Z"
成功レスポンス(200)
{
"data": {
"store": {
"id": "STO_2aUyqjCzEIiEcYMKj7TZtw",
"name": "My Digital Store",
"status": "active",
"logo": null,
"supportEmail": null,
"website": null,
"slug": "my-digital-store-a1b2c3",
"prodEnabled": false,
"webhookSettings": null,
"notificationSettings": null,
"checkoutSettings": null,
"deletedAt": "2026-01-15T12:00:00.000Z",
"createdAt": "2026-01-15T10:30:00.000Z",
"updatedAt": "2026-01-15T12:00:00.000Z"
}
}
}
レスポンスフィールド
ストア作成のレスポンスフィールドと同じです(deletedAt が設定されます)。
エラーレスポンス
| ステータス | エラー | 説明 |
|---|
| 400 | Missing required field: id | リクエストボディに id が指定されていません |
| 403 | Access denied: only owner can delete store | マーチャントロールが admin または member です |
| 404 | Store not found | ストア ID が存在しないか、マーチャントがメンバーではありません |
ストアの削除は論理削除です。ストアデータは保持されますがストアにアクセスできなくなります。この操作は API 経由では取り消せません。