{
  "name": "category.upsert \u2014 create a user category for firmware images",
  "description": "Omitting categoryId creates; the daemon assigns the id and echoes the stored row back.",
  "request": {
    "jsonrpc": "2.0",
    "id": 31,
    "method": "category.upsert",
    "params": {
      "category": {
        "categoryId": "firmware",
        "name": "Firmware",
        "saveDir": "/home/sami/Downloads/Firmware",
        "extensions": [
          "bin",
          "img",
          "fw"
        ],
        "mimeTypes": [],
        "builtin": false,
        "sortOrder": 5
      }
    }
  },
  "response": {
    "jsonrpc": "2.0",
    "id": 31,
    "result": {
      "category": {
        "categoryId": "firmware",
        "name": "Firmware",
        "saveDir": "/home/sami/Downloads/Firmware",
        "extensions": [
          "bin",
          "img",
          "fw"
        ],
        "mimeTypes": [],
        "builtin": false,
        "sortOrder": 5
      }
    }
  },
  "assertions": [
    "builtin is forced false on a created category regardless of what was sent",
    "changing saveDir never moves existing files \u2014 the GUI asks and issues download.update per task"
  ]
}