---
title: "Read persistent Mac authorization [admin]"
method: GET
path: "/desktop/machines/{id}/automation"
tags: ["Desktop"]
---

# Read persistent Mac authorization \[admin\]

`GET /desktop/machines/{id}/automation`

## Request

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

Requires the owner's unrestricted account-wide personal admin key, including for reads. Team/workspace-fixed, task, app, system and restricted credentials are refused. This goes through a dedicated owner-administration path, not ordinary task or mount grants. The Mac must be online and updated. Read the current revision and supported authorization choices. Workspaces containing null name the caller's default workspace.

## Path parameters

- `id` string, required

## Response `200`

OK

- object
  - `enabled` boolean
  - `workspaces` string[]
  - `reachKinds` string[]
  - `hostTools` string[]
  - `folderRoots` string[]
  - `browserOrigins` string[]
  - `deviceAuthorities` string[]
  - `revision` integer
  - `identityReady` boolean
  - `supportedHostTools` string[]
  - `supportedDeviceAuthorities` string[]
  - `supportedReachKinds` string[]

## Other responses

- `401`: Error — { error: { code, message } }
- `403`: Error — { error: { code, message } }
- `404`: Error — { error: { code, message } }
- `409`: Error — { error: { code, message } }
- `503`: Error — { error: { code, message } }

## Changes

- **2026-11-02** `e5e8f0229a99`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/agentsky/apis/agentsky-developer-api/changes/desktop/machines/:id/automation/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/0d435187cd55?raw)