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

# Public APIでのデバイスの一括削除

> Public APIで削除するデバイスを検索してIDを集め、複数のデバイスをまとめて削除する手順を説明します。

> [!NOTE]
>
> デバイス管理機能のご利用には Device管理プランのご契約が必要です。50ID以下の場合は、Device管理プランも無料でご利用いただけます。トライアルや無料でのご利用を希望される場合は、チャットの「**サポート担当者に直接質問する**」からご連絡ください。

## 概要

デバイス画面の一括削除では、50件ごとに削除します。削除するデバイスが多いときや、利用者のメールアドレスなどの条件で探して削除したいときは、[Public API](https://support.i.moneyforward.com/it-management/faq/cw1ivgng0g-admina-api.md)を使うと、まとめて削除できます。

使うAPIは次の2つです。

| 用途 | API |
| - | - |
| デバイスを検索して、削除するデバイスのIDを集める | [Search devices for an organization](https://support.i.moneyforward.com/api-reference/it-management/devices/search-devices-for-an-organization.md) |
| 集めたIDのデバイスを、まとめて削除する | [Delete multiple devices of an organization](https://support.i.moneyforward.com/api-reference/it-management/devices/delete-multiple-devices-of-an-organization.md) |

> [!NOTE]
>
> MDM連携のワークスペースを削除しても、そのワークスペースから取り込まれたデバイスは削除されず、デバイス一覧に残ります。

## 事前準備

1. **設定** > **APIキー一覧**で、APIキーを作成します。手順は「[APIキーの発行](https://support.i.moneyforward.com/it-management/faq/cw1ivgng0g-admina-api.md#generate-api-key)」をご覧ください。
2. **設定** > **APIキー一覧**で、**組織ID**を確認します。手順は「[OrganizationIDの確認](https://support.i.moneyforward.com/it-management/faq/cw1ivgng0g-admina-api.md#organization-id)」をご覧ください。
3. 削除する前に、デバイス一覧をCSVでエクスポートして、控えを残してください。手順は「[デバイスエクスポート](https://support.i.moneyforward.com/it-management/device/erfxlknd5e-1-devices.md#デバイスエクスポート)」をご覧ください。

APIの認証方法は、「[認証](https://support.i.moneyforward.com/api-reference/it-management/authentication.md)」をご覧ください。

## 手順1. 削除するデバイスのIDを集める

[Search devices for an organization](https://support.i.moneyforward.com/api-reference/it-management/devices/search-devices-for-an-organization.md)で、削除するデバイスを検索します。次の例では、利用者のメールアドレス（`people.primaryEmail`）に「@example.com」を含むデバイスを検索します。

```bash theme={null}
curl -X POST "https://api.itmc.i.moneyforward.com/api/v1/organizations/<ORGANIZATION_ID>/devices/search?limit=50" \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{"searchTerm": "@example.com", "searchFields": ["people.primaryEmail"]}'
```

* レスポンスの `items[].id` が、デバイスのIDです。
* レスポンスの `meta.nextCursor` に値が入っているときは、続きがあります。URLに `&cursor=<nextCursor の値>` を付けて、同じリクエストをもう一度送ります。値に `+`・`/`・`=` が含まれるときは、それぞれ `%2B`・`%2F`・`%3D` に置き換えます。`meta.nextCursor` が `null` になるまで繰り返します。
* 集めたIDを、事前準備でエクスポートしたCSVと見比べて、削除してはいけないデバイスが含まれていないか確認します。

## 手順2. デバイスをまとめて削除する

[Delete multiple devices of an organization](https://support.i.moneyforward.com/api-reference/it-management/devices/delete-multiple-devices-of-an-organization.md)で、集めたIDのデバイスを削除します。`deviceIds` に、削除するデバイスのIDを指定します。

> [!WARNING]
>
> デバイスを削除すると、デバイスの利用履歴も削除され、元に戻せません。

```bash theme={null}
curl -X DELETE "https://api.itmc.i.moneyforward.com/api/v1/organizations/<ORGANIZATION_ID>/devices" \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{"deviceIds": [101, 102, 103]}'
```

1回のリクエストで指定できるIDは、100件までです。100件を超えるときは、100件ずつに分けて送ります。APIの呼び出し回数の上限は、「[IT Management API のレート制限](https://support.i.moneyforward.com/api-reference/it-management/rate-limits.md)」をご覧ください。

> [!NOTE]
>
> * 存在しないIDが1件でもあると、1件も削除されずにエラーになります。削除済みのIDと、重複したIDも、存在しないIDと同じ扱いです。

## 手順3. 結果を確認する

デバイス画面で、削除したデバイスが一覧に表示されないことを確認します。APIで削除した操作は、[監査ログ](https://support.i.moneyforward.com/it-management/faq/3kr059fq2z-auditlog.md)に記録されます。

## 関連ページ

* [デバイス管理機能の概要](https://support.i.moneyforward.com/it-management/device/tmkn2wxi35-manage-device.md)
* [Public APIの利用](https://support.i.moneyforward.com/it-management/faq/cw1ivgng0g-admina-api.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.