# Devices Full device inventory pulled from Island Enterprise Browser: every managed browser install the tenant has enrolled, with OS / browser / extension versions, security posture (disk encryption, firewall, screen lock), IPs, user assignment, and lifecycle timestamps. **Sync Type: Full inventory refresh** ## Description Slow-moving reference data. Each sync re-scans the entire device catalogue, so every run reflects the tenant exactly as it stands — devices removed in Island simply stop appearing. Downstream pipelines join device attributes onto per-event streams (such as the SIEM audit stream) using `machineId` or `id`. ## Prerequisites 1. An Island Enterprise Browser tenant with the Management Console accessible. 2. An account with the **admin** or **system-admin** role — required to view the API integration panel and generate an API key. 3. Your tenant's hosting region (US or EU). ## Authentication This input uses the **Management API** key — **not** the SIEM bearer token used by the SIEM Event input. ### The two-credential trap Island exposes two separate credential panels in the Management Console. They are not interchangeable: | Purpose | Console panel | | --- | --- | | **Management pull APIs (this input, plus Users and Compromised Credentials)** | System Settings → Integrations → **API** | | SIEM event queue | System Settings → Integrations → **SIEM** → Generic SIEM Integration | **Do not paste the SIEM bearer token into the API Key field.** It is a different credential for a different set of endpoints and fails with `401 Unauthorized`. ### Generating the API Key 1. Log into the Island Management Console with an **admin** or **system-admin** account. 2. Navigate to **System Settings → Integrations → API**. 3. Create or copy an API key from the panel. The key must belong to an admin-role account. ## Configuration ### Settings | Setting | Type | Required | Description | | ------- | ---- | -------- | ----------- | | Region | string (enum) | Yes | Tenant hosting region. `us` → `management.island.io`, `eu` → `eu.management.island.io`. Match the domain you use to log into the Management Console. | | API Key | secret (string) | Yes | Management API key, from Console → Integrations → **API** panel. **Not** the SIEM bearer token. | | Cron Schedule | string | Yes | Cron expression scheduling the inventory refresh. Default: hourly (`0 * * * *`). See [Cron Expression Syntax](https://crontab.guru/). | ## Backfill and Replay | Guarantee | Supported? | | --- | --- | | Historical backfill | N/A — inventory is always "now" | | Replay | Yes — each sync is a full re-scan; deleted devices simply disappear | | Incremental cursor | No — Island exposes no "changed since" filter on this inventory | ## Rate limits and throughput Island publishes no explicit ceiling; Monad caps outbound calls at roughly **1 request/second** per input and reads 100 devices per request. A 5,000-device tenant therefore takes about a minute per sync — worth knowing before you tighten the schedule. ## Troubleshooting - **`401 Unauthorized`** — Wrong credential type. Confirm the key is from the **API** integration panel, not the **SIEM** panel. - **`403 Forbidden`** — Key belongs to a non-admin account, or API integration is disabled on the tenant. Verify the account role. - **No records emitted** — Confirm the tenant actually has enrolled devices. On a fresh Island install with zero installs, an empty result is correct. - **`429 Too Many Requests`** — Something else is also calling the same tenant's Management API. Lengthen the schedule. ## Example A single record: ```json { "id": "a969daa7-0c81-5f6d-e1a3-37c5111f65a9", "createdDate": "2026-08-20T11:02:10Z", "updatedDate": "2026-09-11T09:17:21Z", "tenantId": "44fd7df5-f6f2-8b15-a587-587c6416b168", "machineId": "MCHN504912", "machineName": "WS-MAC-A4B7C", "machineModel": "MacBook Pro 16", "serialNumber": "C02ZR1ABMD6T", "userId": "user-4821-abcd", "userName": "Alice Johnson", "email": "alice.johnson@example.com", "osPlatform": "MacOs", "osVersion": "macOS 14.6.1", "browserVersion": "1.18.2.1001", "chromiumVersion": "126.0.6478.182", "diskEncrypted": true, "osFirewallEnabled": true, "osScreenLockEnabled": true, "internalIpAddress": "192.222.95.111", "externalIpAddress": "114.160.21.188", "status": "Active", "lastSeen": "2026-09-11T09:17:21Z", "deviceType": "Laptop", "manufacturer": "Apple", "authMethod": "TenantToken" } ``` ## Sync frequency This input runs on a cron schedule (default hourly, `0 * * * *`), which you can configure on the pipeline. Tighten the schedule if you need faster onboarding/offboarding visibility, but note the 1 QPS rate cap. See [Input Sync Frequency](../../guides/sync-frequency) for details.