Upload a File
Upload a file’s raw bytes to the presigned URL returned by the Create or Update endpoints.
PUT <upload.url from create/update response>
| Header | Required | Description |
|---|
Content-Type | Yes | Must match the content type from the upload object’s headers |
Request Body
The raw file bytes. Do not wrap in JSON — send the file content directly.
Example
# Using the URL from the create response
curl -X PUT "https://simplehost.dev/api/v1/_upload/sites%2Fbright-canvas-a7k2%2F01jm4abc123%2Findex.html?token=abc123&ct=text%2Fhtml&exp=1711050000000" \
-H "Content-Type: text/html" \
--data-binary "@./dist/index.html"
Response (200)
Empty body on success.
Errors
| Status | Reason |
|---|
| 400 | Upload URL has expired (1 hour TTL) |
| 400 | No request body provided |
| 500 | Upload to storage failed |
Important Notes
Upload URLs expire after 1 hour. If they expire, you’ll need to create a new version by calling the publish endpoint again.
- Upload all files listed in the
uploads array before calling Finalize
- Files in the
skipped array (hash matches) do not need to be uploaded
- Upload order doesn’t matter — you can upload files in parallel
- The
--data-binary flag is important when using curl — it preserves the raw bytes without any processing
