AI Discovery

List Devices

Returns the devices reporting to your organization via the Willow Scan Agent, including the capability counts and AI agents detected on each device.

get/api/discovery/devices

Request

Base URL: https://app.withwillow.ai
URL: https://app.withwillow.ai/api/discovery/devices
Auth: HTTP bearer

Query parameters

cursorinteger

Zero-based cursor offset for pagination.

limitinteger

Maximum number of devices to return (1-200).

status'active' | 'stale'

Filter by activity. active devices scanned recently; stale devices have not scanned within the staleness window.

staleDaysinteger

Number of days without a scan before a device is considered stale. Defaults to 3. Use with status=stale to poll for devices that stopped reporting (for example, staleDays=2 for a daily keepalive with one day of buffer).

Response

List of devices retrieved successfully

activeCountinteger

Total number of active devices

staleCountinteger

Total number of stale devices

Example response

{
  "data": [
    {
      "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
      "deviceId": "e3b0c44298fc1c149afbf4c8996fb924",
      "hostname": "johns-macbook",
      "username": "john",
      "os": "macOS 14.5",
      "platform": "darwin",
      "architecture": "arm64",
      "lastScanDate": "2024-06-01T12:00:00Z",
      "capabilityCounts": {
        "mcp_server": 4,
        "skill": 2,
        "memory": 1
      },
      "sourceApplications": [
        "cursor",
        "claude-code"
      ],
      "aiAgents": [
        "cursor",
        "claude-code"
      ],
      "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "userName": "John Doe",
      "userEmail": "john@example.com",
      "agentVersion": "1.4.2"
    }
  ],
  "pagination": {
    "hasMore": true,
    "total": 128
  },
  "activeCount": 42,
  "staleCount": 7
}

Changes

No recorded changes to this operation across all 1 revision of this API.