Devices

Read your Device

Returns a device and its approved roots. Default scope exposes only the caller's devices; scope=workspace requires an owner or admin. Inspect status, online, compatible and compatibility_reason before choosing an execution target. Invalid or inaccessible IDs return 404 device_not_found.

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

get/v3/organizations/{orgId}/devices/{deviceId}

Request

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

Query parameters

scope'owned' | 'workspace'

Inventory scope. workspace requires an owner or admin role.

Response

Owned Device.

Example response

{
  "device": {
    "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.