Files
Start large upload
Get a signed URL to upload a file of up to 2 GB to a computer.
POST
Start file upload
Step one of the two-step upload, for files up to 2 GB. It returns a signed URL and an
upload_token. PUT the file’s bytes to the URL, then call Complete large upload to have the computer pull the file into place. The bytes go straight to storage and never pass through Orgo’s API.
The file lands on one computer only. No file record is written, so it does not appear in the list endpoint. For files up to 10 MB that should be stored in the workspace, use Upload file.
Request
Send a JSON body.Computer ID (UUID) the file goes to. The computer does not need to be running yet. It must be running when you complete the upload.
Name the file will have on the computer. A plain name only: no
/ or \, not . or .., at most 255 characters.Exact size of the file in bytes, from 1 to 2147483648 (2 GB). The signed URL accepts a body of exactly this size and no other.
Absolute folder on the computer, such as
/root/Documents or, on Windows, C:\Users\Public. Omit it, or send desktop, for the desktop folder of the computer’s user. A folder that does not exist is created.Response
Pass it to Complete large upload. It is valid for one hour and only for the same caller and computer.
Example
Response
Errors
Every error carries the shape{"error": "<message>"}. The scope-mismatch 403 adds code, key_workspace_id, and target_workspace_id. The checks below run in order.
Authorizations
Body
application/json
Response
Where to send the bytes, and the token to finish with.