---
title: "The person's Macs connected through the Mac app [read]"
method: GET
path: "/desktop/machines"
---

# The person's Macs connected through the Mac app \[read\]

`GET /desktop/machines`

## Request

- Base URL: `https://api.agentsky.dev/v1`
- URL: `https://api.agentsky.dev/v1/desktop/machines`
- Auth: HTTP bearer

## Response `200`

OK

- DesktopMachineList
  - `machines` DesktopMachine[], required
    - `id` string, required: mac_…
    - `name` string, required
    - `online` boolean, required: The Mac app polled within the last minute
    - `last_seen_at` string, date-time, nullable, required
    - `created_at` string, date-time, required
    - `reach` DesktopMachineReach
      - `kinds` string[], required: What a reach request may ask this Mac for now. host: the Mac app's own local Claude Code and Codex chats, call notes, uploads to workspace files, saves to Downloads, local git (apply a session's changes, open a pull request), WeChat reader and local sync; every change through it is confirmed on the Mac per call
      - `screen` 'ready' | 'off' | 'needs_permission' | 'unavailable', required: off: the person has not turned on lending the screen; needs_permission: macOS has not granted AgentSky Screen Recording or Accessibility (only the person can, in System Settings)
    - `mounts` DesktopListedMount[]: The live folders, browser windows, screens and host reaches (the Mac's apps and files) lent from this Mac. Personal keys only: a workspace key never sees what a person lent. Capability URLs are never listed.
      - `id` string, required: dmt_…
      - `kind` 'folder' | 'browser' | 'screen' | 'host', required
      - `label` string, required
      - `root` string: The folder's absolute path on the Mac (folders only)
      - `created_at` string, date-time, required

## Other responses

- `default`: Error — { error: { code, message, request_id } }

## Changes

- **2026-11-02** `e5e8f0229a99`: 6 info
  - added the optional property `error/request_id` to the response with the `default` status
  - added the optional property `machines/items/mounts` to the response with the `200` status
  - added the optional property `machines/items/reach` to the response with the `200` status
  - the response property `error` became required for the status `default`
  - …2 more

[Operation history](https://skmtc.dev/agentsky/apis/agentsky-developer-api/changes/desktop/machines/get.md)

---

[API](https://skmtc.dev/agentsky/apis/agentsky-developer-api.md) - [All operations](https://skmtc.dev/agentsky/apis/agentsky-developer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/agentsky/apis/agentsky-developer-api/revisions/8280a065ef6a?raw)