AGagentsky
Desktop

Request native Mac relaunch [admin]

Changed on

Returns 202 admission with completion pending; relaunch executes only after acknowledgement. Does not prove that a new process is running. Requires the authenticated machine owner's unrestricted account-wide personal admin key. Workspace-fixed, team, task, app, system and restricted credentials are refused. Uses the existing fixed owner-administration transport, not ordinary task grants. Native OS permissions, path protections and destination membership remain enforced. No raw IPC or secret-key ingress. Reuse request_id on retry. The complete request remains subject to the relay envelope size limit.

post/desktop/machines/{id}/administration/device_relaunch

Request

  • Base URL
    https://api.agentsky.dev/v1
  • URL
    https://api.agentsky.dev/v1/desktop/machines/{id}/administration/device_relaunch
  • Auth
    HTTP bearer

Path parameters

idstring required

Owned Mac machine id

Query parameters

workspacestring

Checked operation context; empty selects the owner's default workspace. Global settings still require account-wide owner authority.

Request body

argumentsobject required
request_idstring required

Response

Admitted only; native action runs after acknowledgement, completion is not proven

requestedtrue required
action'sign_out' | 'relaunch' | 'restart_to_update' required
completion'pending' required

Changes