{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://velox.dev/schema/methods/download.addBatch.schema.json",
  "title": "download.addBatch",
  "description": "Create many tasks in one call: the clipboard blob, the wildcard expander, and the extension's 'Download all links'. Partial success is normal and is reported per item rather than failing the whole batch.",
  "x-privileged": false,
  "x-transports": ["uds", "ws"],
  "x-deadlineMs": 30000,
  "x-errors": [-32011, -32012],
  "x-wsRestrictions": ["Same saveDir restriction as download.add, applied to defaults and to every item."],
  "type": "object",
  "properties": {
    "params": {
      "type": "object",
      "additionalProperties": false,
      "required": ["items"],
      "properties": {
        "items":    { "type": "array", "minItems": 1, "maxItems": 5000, "items": { "$ref": "https://velox.dev/schema/types/DownloadSpec.schema.json" } },
        "defaults": { "oneOf": [{ "$ref": "https://velox.dev/schema/types/DownloadSpec.schema.json" }, { "type": "null" }], "description": "Applied to any field an item left unset. Its url is ignored." }
      }
    },
    "result": {
      "type": "object",
      "additionalProperties": false,
      "required": ["taskIds", "failed"],
      "properties": {
        "taskIds": { "type": "array", "items": { "type": "string", "format": "uuid" }, "description": "In the same order as the accepted items." },
        "failed": {
          "type": "array",
          "description": "One entry per item that could not be added. index refers to params.items.",
          "items": {
            "type": "object",
            "additionalProperties": false,
            "required": ["index", "code", "message"],
            "properties": {
              "index":   { "type": "integer", "minimum": 0 },
              "code":    { "$ref": "https://velox.dev/schema/types/ErrorCode.schema.json" },
              "message": { "type": "string" }
            }
          }
        }
      }
    }
  }
}