---
title: "Read native Mac sign-in state [admin]"
method: POST
path: "/desktop/machines/{id}/administration/device_auth_state"
tags: ["Desktop"]
---

# Read native Mac sign-in state \[admin\]

`POST /desktop/machines/{id}/administration/device_auth_state`

## Request

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

Read native sign-in state without returning credentials or secret login material. 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 `200`

Canonical native-owner result; private, no-store

## 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_auth_state/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)