---
title: "Update Download"
method: PATCH
path: "/utilities/downloads/{id}"
tags: ["Utilities"]
---

# Update Download

`PATCH /utilities/downloads/{id}`

Partially update completed or failed download display metadata and processing options; active downloads cannot be changed

## Path parameters

- `id` integer, required

## Request body

- GithubComAlchemillahqSylveInternalInterfacesServicesUtilitiesUpdateDownloadRequest
  - `automaticExtraction` boolean
  - `automaticRawConversion` boolean
  - `name` string
  - `uType` 'base-rootfs' | 'cloud-init' | 'uncategorized'

## Response `200`

Success

- GithubComAlchemillahqSylveInternalAPIResponseGithubComAlchemillahqSylveInternalDbModelsUtilitiesDownloads
  - `data` GithubComAlchemillahqSylveInternalDbModelsUtilitiesDownloads
    - `automaticExtraction` boolean
    - `automaticRawConversion` boolean
    - `createdAt` string
    - `error` string
    - `extractedPath` string
    - `files` GithubComAlchemillahqSylveInternalDbModelsUtilitiesDownloadedFile[]
      - `download` GithubComAlchemillahqSylveInternalDbModelsUtilitiesDownloads — recursive
      - `downloadId` integer
      - `id` integer
      - `name` string
      - `size` integer
    - `id` integer
    - `ignoreTLS` boolean
    - `name` string
    - `path` string
    - `progress` integer
    - `size` integer
    - `status` 'pending' | 'processing' | 'done' | 'failed'
    - `type` 'http' | 'torrent' | 'path'
    - `uType` 'base-rootfs' | 'cloud-init' | 'uncategorized'
    - `updatedAt` string
    - `url` string
    - `uuid` string
  - `error` string
  - `message` string
  - `status` string

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Download not found
- `409` — Download is active
- `413` — Request body too large
- `422` — Unsupported metadata or processing options
- `500` — Internal Server Error
- `503` — Queue unavailable

---

[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/9822c41c8ac0/schema)