Devices

List your Devices

Lists Mac/headless Devices one page at a time: first Devices per page (200 unless given), and when has_next_page is true, end_cursor passed as after reads the next page, so no Device is left out. A Device with its roots is about 3 KB; ask for a smaller first where the size of one response matters. The default owned scope lists the caller's devices; scope=workspace lists all devices in the workspace for owners and admins. Expired and revoked entries are included, after the Devices that are still connected and unexpired; each group is newest first. Managed infrastructure is excluded. An after this list did not return is refused with 400 invalid_cursor.

<sub>Scope: devices:read</sub>

get/v3/organizations/{orgId}/devices

Request

  • Base URL: https://api.reasonmachines.com
  • URL: https://api.reasonmachines.com/v3/organizations/{orgId}/devices
  • Auth: HTTP bearer

Query parameters

scope'owned' | 'workspace'

Inventory scope. workspace requires an owner or admin role.

firstinteger

Devices per page.

afterstring

The previous page's end_cursor.

Response

One page of Devices.

end_cursorstring nullable required

Pass as after for the next page; null on the last page.

has_next_pageboolean required

Whether more Devices follow this page.

Example response

{
  "devices": [
    {
      "id": "11111111-1111-4111-8111-111111111111",
      "name": "Build worker",
      "kind": "headless",
      "os": "linux",
      "architecture": "arm64",
      "device_model": null,
      "device_chip": null,
      "device_location": null,
      "reason_runtime_version": "1.0.0",
      "ara_runtime_version": "1.0.0",
      "bridge_version": "1.0.0",
      "status": "active",
      "lifecycle": "persistent",
      "expires_at": "2026-10-23T09:00:00Z",
      "last_seen_at": "2026-09-23T09:00:00Z",
      "online": false,
      "compatible": false,
      "compatibility_reason": "offline",
      "created_at": "2026-09-23T09:00:00Z",
      "updated_at": "2026-09-23T09:00:00Z",
      "protocol_version": 1,
      "capabilities": {},
      "roots": []
    }
  ]
}

Changes

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