---
title: "Save an Arena chart PNG [admin]"
method: POST
path: "/desktop/machines/{id}/administration/device_save_arena_chart"
tags: ["Desktop"]
---

# Save an Arena chart PNG \[admin\]

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

## Request

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

Save a PNG through the native export owner in an authorized writable folder. Supply dataUrl or a workspace fileId with exact sizeBytes and sha256. Upload large files using the existing Files API; their streamed bytes and SHA-256 must match before native commit. Creates a new file unless replaceExisting explicitly requests regular-file replacement; protected paths and symlinks remain refused. 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
    - `dataUrl` string
    - `fileId` string
    - `sizeBytes` integer
    - `sha256` string
    - `filePath` string, required
    - `replaceExisting` boolean
  - `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_save_arena_chart/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)
