Files

Read resumable upload status

Read staged bytes and completion state before retrying an interrupted upload. Uses the guest agent and may resume the computer unless no_wake=1. A missing upload returns 404. This reads metadata; it does not publish a staged file.

Requires the member role or higher.

get/computers/{id}/files/uploads

Request

  • Base URL: https://app.mandala.computer/api/v1
  • URL: https://app.mandala.computer/api/v1/computers/{id}/files/uploads
  • Auth: HTTP bearer

Path parameters

idstring required

The computer id.

Query parameters

pathstring required

Normalized absolute destination file path, at most 4096 bytes, with no control characters and no empty, . or .. segment; the parent directory must exist. Anything else is a 400.

upload_idstring required

A fresh random 32-character lowercase hex ID. Save it with path and the source file to resume.

no_wake'1'

Set to 1 to require a running computer without automatic resume: a computer that is not running answers 409 with reason: unavailable rather than being resumed. Any other value is a 400.

Response

Current progress, including a receipt for a completed upload until DELETE.

pathstring required

Destination inside the guest.

upload_idstring required

Client-generated 32 lowercase hex characters identifying this upload.

offsetinteger required

Bytes staged. Resume from this offset; do not guess after a lost response.

sizeinteger required

Declared total file size, at most 2147483648 bytes (2 GiB).

completeboolean required

The complete file has been published at path.

Changes

No recorded changes to this operation across all 1 revision of this API.