v1

latestOpenAPI 3.1.02026-07-261690320.7 KB

List endpoint devices

Returns a list of all the endpoint protection devices

get/endpoint-protection/devices

Response

A list of all the endpoint protection devices

idinteger

The ID of the device in Aikido

namestring

The name of the device

osstring

The operating system of the device

versionstring

The version of the Aikido endpoint protection software installed on the device

userstring

The user of the device

permission_group_idinteger

The ID of the permission group related to the device

permission_group_namestring

The name of the permission group related to the device

last_heartbeat_atinteger

The Unix timestamp of the last heartbeat of the device sent by the Aikido endpoint protection software

status'offline' | 'not_protected' | 'protected'

The status of the device

Example response

[
  {
    "id": 1,
    "name": "Yuri's MacBook Pro",
    "os": "macos",
    "version": "1.0.0",
    "user": "Yuri Dart",
    "permission_group_id": 1,
    "permission_group_name": "Default",
    "last_heartbeat_at": 1716854400,
    "status": "protected"
  },
  {
    "id": 2,
    "name": "Sugman's MacBook Pro",
    "os": "macos",
    "version": "1.0.3",
    "user": "Sugman Utz",
    "permission_group_id": 2,
    "permission_group_name": "Sales",
    "last_heartbeat_at": 1716854400,
    "status": "offline"
  }
]