search_devices
Filter and find devices by name, model, OS, app version, log activity, and more. Sort results to identify active or matching devices for debugging.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"app_id": "<app_id>"
},
"name": "search_devices"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Filter by device name. Use * as suffix wildcard (e.g. iPhone*) | |
| model | No | Filter by device model. | |
| order | No | Sort order. Defaults to last_active. | last_active |
| app_id | Yes | The public app ID (e.g. 5X3c4veRGV) from list_apps | |
| enabled | No | Filter by enabled (true) or disabled (false) devices. | |
| os_name | No | Filter by operating system name (e.g. iOS, Android). | |
| log_text | No | Filter devices that have logs matching this text. | |
| log_level | No | Filter devices that have logs at this level. 0=Debug, 1=Warning, 2=Error, 3=Trace, 4=Info, 5=Fatal | |
| page_size | No | ||
| os_version | No | Filter by OS version string. | |
| next_cursor | No | Cursor for next page, from pagination.next_cursor in previous response. | |
| date_range_end | No | ISO 8601 datetime. Filter devices active up to this date. | |
| date_range_start | No | ISO 8601 datetime. Filter devices active from this date. | |
| current_app_version | No | Filter devices currently running this app version. |