{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://velox.dev/schema/methods/download.remove.schema.json",
  "title": "download.remove",
  "description": "Drop tasks from the list, optionally deleting the bytes on disk. Privileged: this is the only method that destroys user data, and the extension is never allowed to reach it. The daemon deletes the .veloxpart and .veloxpart.meta pair, and the finished file only when deleteFile is true.",
  "x-privileged": true,
  "x-transports": ["uds"],
  "x-deadlineMs": 10000,
  "x-errors": [-32003, -32010],
  "type": "object",
  "properties": {
    "params": {
      "type": "object",
      "additionalProperties": false,
      "required": ["taskIds", "deleteFile"],
      "properties": {
        "taskIds":    { "type": "array", "minItems": 1, "maxItems": 5000, "items": { "type": "string", "format": "uuid" } },
        "deleteFile": { "type": "boolean", "description": "Explicit and required — there is no default for deleting a user's file." }
      }
    },
    "result": {
      "type": "object",
      "additionalProperties": false,
      "required": ["removed", "failed"],
      "properties": {
        "removed": { "type": "array", "items": { "type": "string", "format": "uuid" } },
        "failed": {
          "type": "array",
          "items": {
            "type": "object",
            "additionalProperties": false,
            "required": ["taskId", "code", "message"],
            "properties": {
              "taskId":  { "type": "string", "format": "uuid" },
              "code":    { "$ref": "https://velox.dev/schema/types/ErrorCode.schema.json" },
              "message": { "type": "string" }
            }
          }
        }
      }
    }
  }
}