sophos_list_endpoints
Retrieve and filter endpoints from a Sophos Central tenant by type, health status, tamper protection, hostname, and more. Returns paginated results.
Instructions
List endpoints in a Sophos Central tenant with optional filtering by type, health status, tamper protection, hostname, or free-text search. Returns paginated results.
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": {
"tenant_id": "<tenant_id>"
},
"name": "sophos_list_endpoints"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| type | No | Filter by endpoint type | |
| view | No | Type of view to return (basic/summary/full) | |
| fields | No | Comma-separated list of fields to include in a partial response | |
| online | No | Filter to only online endpoints | |
| search | No | Free-text search across endpoint fields | |
| page_key | No | Pagination key from a previous response | |
| group_ids | No | Comma-separated group UUIDs to filter by assigned group | |
| page_size | No | Number of results per page (default 50) | |
| tenant_id | Yes | Target tenant ID | |
| ip_addresses | No | Comma-separated IP addresses to filter by | |
| health_status | No | Filter by overall health status | |
| mac_addresses | No | Comma-separated MAC addresses to filter by (EUI-48 or EUI-64) | |
| tamper_enabled | No | Filter by tamper protection enabled/disabled | |
| last_seen_after | No | Find endpoints last seen after this date-time (ISO 8601) | |
| isolation_status | No | Filter by isolation status | |
| last_seen_before | No | Find endpoints last seen before this date-time (ISO 8601) | |
| hostname_contains | No | Filter endpoints whose hostname contains this substring |