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

# Configure persistent Mac authorization \[admin\]

`PATCH /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. Pass only fields to change, the expectedRevision from a fresh read and a stable request_id reused on retries. Revision conflicts require re-reading; no blind overwrites. Host tools, destinations, folder roots and device authorities are validated by the same native Settings owner. OS grants remain separate.

## Path parameters

- `id` string, required

## Request body

- object
  - `expectedRevision` integer, required
  - `request_id` string, required
  - `enabled` boolean
  - `workspaces` string[]
  - `reachKinds` string[]
  - `hostTools` string[]
  - `folderRoots` string[]
  - `browserOrigins` string[]
  - `deviceAuthorities` string[]

## 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

- `400`: Error — { error: { code, message } }
- `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/patch.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)