---
title: "Request native Mac relaunch [admin]"
method: POST
path: "/desktop/machines/{id}/administration/device_relaunch"
tags: ["Desktop"]
---

# Request native Mac relaunch \[admin\]

`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

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.

## Path parameters

- `id` string, required

## Query parameters

- `workspace` string

## Request body

- object
  - `arguments` object, required
  - `request_id` string, required

## Response `202`

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

- object
  - `requested` true, required
  - `action` 'sign_out' | 'relaunch' | 'restart_to_update', required
  - `completion` 'pending', required

## 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 } }
- `413`: Error — { error: { code, message } }
- `502`: 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/administration/device_relaunch/post.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)