{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://velox.dev/schema/methods/download.update.schema.json",
  "title": "download.update",
  "description": "Change a task's mutable fields. Moving saveDir or filename moves the file on disk in the same operation, which is what makes dragging a row onto a category work as one RPC. Privileged: it can name a destination path.",
  "x-privileged": true,
  "x-transports": ["uds"],
  "x-deadlineMs": 30000,
  "x-errors": [-32003, -32010, -32011],
  "type": "object",
  "properties": {
    "params": {
      "type": "object",
      "additionalProperties": false,
      "required": ["taskId", "patch"],
      "properties": {
        "taskId": { "type": "string", "format": "uuid" },
        "patch": {
          "type": "object",
          "additionalProperties": false,
          "description": "Only the present fields change. An explicit null clears a nullable field.",
          "properties": {
            "filename":    { "type": ["string", "null"], "maxLength": 255 },
            "saveDir":     { "type": ["string", "null"] },
            "categoryId":  { "type": ["string", "null"] },
            "queueId":     { "type": ["string", "null"] },
            "description": { "type": ["string", "null"], "maxLength": 1024 },
            "segments":    { "type": ["integer", "null"], "minimum": 1, "maximum": 32, "description": "Takes effect on the next start; a running task is not re-segmented underneath the user." },
            "bufferBytes": { "type": ["integer", "null"], "minimum": 4096, "maximum": 8388608 },
            "checksum":    { "oneOf": [{ "$ref": "https://velox.dev/schema/types/Checksum.schema.json" }, { "type": "null" }] }
          }
        }
      }
    },
    "result": { "$ref": "https://velox.dev/schema/types/TaskSummary.schema.json" }
  }
}