---
title: "Stage a Downloader Upload"
method: POST
path: "/utilities/downloader-uploads"
tags: ["Utilities"]
---

# Stage a Downloader Upload

`POST /utilities/downloader-uploads`

Stream exactly one file from the filepond multipart field into bounded, short-lived downloader staging and return an opaque upload identity without exposing the server path

## Response `201`

Upload staged

- GithubComAlchemillahqSylveInternalAPIResponseInternalHandlersUtilitiesDownloaderUploadReceipt
  - `data` InternalHandlersUtilitiesDownloaderUploadReceipt
    - `bytes` integer
    - `name` string
    - `status` 'staged' | 'completed'
    - `uploadId` string
  - `error` string
  - `message` string
  - `status` string

## Other responses

- `400` — Invalid filename, file field, or multipart request
- `401` — Unauthorized
- `403` — Administrator access or staging permission required
- `408` — Upload cancelled or timed out
- `409` — Upload identity collision
- `413` — File or multipart request too large
- `429` — Upload capacity exhausted
- `500` — Internal Server Error
- `503` — Upload persistence unavailable
- `507` — Insufficient storage or quota

---

[API](https://skmtc.net/alchemillahq/apis/sylve-api.md) · [All operations](https://skmtc.net/alchemillahq/apis/sylve-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/alchemillahq/sylve-api/revisions/7a7bea85004e/schema)