Files

Read resumable upload status (headers only)

The GET of this path with no response body. It is authorized exactly as the GET is and answers its statuses and headers, never a body: an error’s correlation is in X-Request-ID alone. Range is ignored. It runs the GET’s own read and discards the body, so it touches whatever that read touches, the guest included: it is not a lighter way to poll.

Requires the member role or higher.

head/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.

Changes

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