Batch Resolve Device IDs by Name

Tool Name: airdroid_business_device_id_batch_resolve_by_name

Risk Level: 🟢 Low Risk

Execution Mode: ⚡ Synchronous

Category: Device Management

Quick Start (Copy & Use)

Summary: Resolve multiple exact device names to device_id values. Returns flat DeviceIds, name/id DeviceIdPairs, and UnmatchedDeviceNames.

Prerequisites: Exact device_name values (case-sensitive). Max 50 names.

Success Criteria: StatusCode == 200 and ErrorMessage == "".

What to Do Next: Pass DeviceIds into batch device tools (e.g. Batch Get Devices by Device or Group IDs). Review UnmatchedDeviceNames before proceeding.

Minimal Request Example:

{
  "DeviceNames": ["Test Device 01", "Warehouse Tablet 02"]
}

Minimal Response Example:

{
  "DeviceIds": ["fa6edcff65ab444e8b5e0eb08df4175d"],
  "DeviceIdPairs": [
    {
      "device_name": "Test Device 01",
      "device_id": "fa6edcff65ab444e8b5e0eb08df4175d"
    }
  ],
  "UnmatchedDeviceNames": ["Warehouse Tablet 02"],
  "StatusCode": 200,
  "ErrorMessage": ""
}

Recipes (Common Recipes)

Recipe 1: Prepare DeviceIds for batch get

{
  "DeviceNames": ["Front Desk Monitor", "Lobby Kiosk A"]
}

Then call Batch Get Devices by Device or Group IDs with the returned DeviceIds.

Recipe 2: Check unmatched before acting

After a successful call, if UnmatchedDeviceNames is non-empty, fix names (or fuzzy-search via List Devices) before downstream writes.

Recipe 3: Single-name alternative

For one device with full details, prefer Get a Device by Name instead of this batch wrapper.

{
  "DeviceNames": ["Office Tablet"]
}

1. Overview

1.1 What it does

Performs exact-name device lookup and returns ID-oriented outputs only (not full device records).

1.2 When to use

• Convert several known device names into a flat DeviceIds array
• Prepare ids for downstream batch device operations

1.3 Execution mode

Synchronous read. Idempotent.

1.4 Prerequisites

Exact device display names. Partial / fuzzy names are not supported here.

1.5 Related tools

1.6 vs similar tools

2. Inputs

Each value is matched against device_name using exact matching. Partial names are not supported.

3. Outputs

On success, the tool returns StatusCode: 200 and Retryable: false. Parameter errors return -1; request or system errors return 500.

4. Error handling

Unmatched names alone are not a failure when ErrorMessage is empty — they appear in UnmatchedDeviceNames.

5. Limits & gotchas

• Max 50 names per call
• Exact match only (case-sensitive)
• Does not return full device fields — use Search Devices / Batch Get Devices… after resolving

6. Best practices

1. Always inspect UnmatchedDeviceNames before write operations
2. Split large name lists into chunks of ≤ 50
3. Use List Devices Keyword when names are approximate

7. Related Tools

8. Tool Chains

Batch Resolve Device IDs by Name → Batch Get Devices by Device or Group IDs

List Devices (Keyword) → pick exact names → Batch Resolve Device IDs by Name

Appendix Reference:

• Field Reference: ./Field Reference.md
• Error Code Quick Reference: ./Error Codes.md