From ef3a01a49ce844ed38031461dbb9b7e0bb0b08c4 Mon Sep 17 00:00:00 2001 From: JackyHe398 on OldHome_main Date: Thu, 18 Jun 2026 22:04:49 +0800 Subject: [PATCH 1/8] docs: add new torrent status --- WebUI-API-(qBittorrent-5.0).md | 16 +++++++++------- 1 file changed, 9 insertions(+), 7 deletions(-) diff --git a/WebUI-API-(qBittorrent-5.0).md b/WebUI-API-(qBittorrent-5.0).md index e2efed6..303b79f 100644 --- a/WebUI-API-(qBittorrent-5.0).md +++ b/WebUI-API-(qBittorrent-5.0).md @@ -1475,13 +1475,15 @@ Property | Type | Description Possible values of `status`: -Value | Description --------|------------ -0 | Tracker is disabled (used for DHT, PeX, and LSD) -1 | Tracker has not been contacted yet -2 | Tracker has been contacted and is working -3 | Tracker is updating -4 | Tracker has been contacted, but it is not working (or doesn't send proper replies) +Value | Status | Description +-------|---------------|------------ +0 | DISABLED | Tracker is disabled (used for DHT, PeX, and LSD) +1 | NOT_CONTACTED | Tracker has not been contacted yet +2 | WORKING | Tracker has been contacted and is working +3 | UPDATING | Tracker is updating +4 | NOT_WORKING | Tracker has been contacted, but it is not working (or doesn't send proper replies) +5 | TRACKER_ERROR | Tracker is reachable but explicitly returned a failure/error message. +6 | UNREACHABLE | A network-level error occurred when contacting the tracker (e.g. failed DNS resolution, refused connection, etc.) Example: From 9db22d744cf110f22ad770862856de82cccdba5f Mon Sep 17 00:00:00 2001 From: JackyHe398 on OldHome_main Date: Thu, 18 Jun 2026 22:07:28 +0800 Subject: [PATCH 2/8] docs: add app/getDirectoryContent --- WebUI-API-(qBittorrent-5.0).md | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+) diff --git a/WebUI-API-(qBittorrent-5.0).md b/WebUI-API-(qBittorrent-5.0).md index 303b79f..14cbea0 100644 --- a/WebUI-API-(qBittorrent-5.0).md +++ b/WebUI-API-(qBittorrent-5.0).md @@ -769,6 +769,30 @@ HTTP Status Code | Scenario 200 | Cookies were saved 400 | Request was not a valid json array of cookie objects +## Get directory content + +Name: `getDirectoryContent` + +|Parameter| Type| Description| +|-|-|-| +|dirPath|string| Absolute path to directory| +|show|string|Define which elements should be listed: `all`, `files`, `dirs`| + +Returns: + +|HTTP Code|Scenario| +|-|-| +|200|Success| +|400|Invalid path| +|404|Directory not found| + +In case of success, the response will be a JSON array with the names of elements in the directory. +For example `/api/v2/app/getDirectoryContent?dirPath=%2Fhome&show=all` could return: + +```json +["admin","johnny"] +``` + # Log # All Log API methods are under "log", e.g.: `/api/v2/log/methodName`. From 3b6fdaad549732b89f3747c59fc7a9470fb02a14 Mon Sep 17 00:00:00 2001 From: JackyHe398 on OldHome_main Date: Thu, 18 Jun 2026 22:13:54 +0800 Subject: [PATCH 3/8] docs: add app/processInfo --- WebUI-API-(qBittorrent-5.0).md | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/WebUI-API-(qBittorrent-5.0).md b/WebUI-API-(qBittorrent-5.0).md index 14cbea0..1a700ef 100644 --- a/WebUI-API-(qBittorrent-5.0).md +++ b/WebUI-API-(qBittorrent-5.0).md @@ -791,6 +791,15 @@ For example `/api/v2/app/getDirectoryContent?dirPath=%2Fhome&show=all` could ret ```json ["admin","johnny"] + +## Get process info + +Name: `processInfo` + +returns the launching time stamp of the application. + +```json +{"launch_time":1781693511} ``` # Log # From 65054cc65ecfddbaffe7950511228d7112ac7736 Mon Sep 17 00:00:00 2001 From: JackyHe398 on OldHome_main Date: Thu, 18 Jun 2026 22:32:47 +0800 Subject: [PATCH 4/8] docs: add torrents/setComment --- WebUI-API-(qBittorrent-5.0).md | 28 ++++++++++++++++++++++++++++ 1 file changed, 28 insertions(+) diff --git a/WebUI-API-(qBittorrent-5.0).md b/WebUI-API-(qBittorrent-5.0).md index 1a700ef..54b62a7 100644 --- a/WebUI-API-(qBittorrent-5.0).md +++ b/WebUI-API-(qBittorrent-5.0).md @@ -2710,6 +2710,34 @@ HTTP Status Code | Scenario 409 | Invalid `newPath` or `oldPath`, or `newPath` already in use 200 | All other scenarios +## set comment + +Name: `setComment` + +Allow setting or modifying comment of a specific torrent. A `post` request with hashes and comment is required. + +```http +POST /api/v2/torrents/setComment HTTP/1.1 +Host: blabla +User-Agent: python-requests/2.x.x +Accept-Encoding: gzip, deflate +Accept: */* +Connection: keep-alive +Content-Type: application/x-www-form-urlencoded +Content-Length: 29 + +hashes=8c212779b4abde7c6bc608063a0d008b7e40ce32&comment=some_comment +``` + + +HTTP Status Code | Scenario +----------------------------------|--------------------- +400 | Missing `hashes` or `comment` parameter +200 | All other scenarios + +The request will be ignored if the torrent hash is invalid. + + # RSS (experimental) # All RSS API methods are under "rss", e.g.: `/api/v2/rss/methodName`. From e87ff7c07b953092c4cb0d4636f38ff46dd523a0 Mon Sep 17 00:00:00 2001 From: JackyHe398 on OldHome_main Date: Thu, 18 Jun 2026 22:33:06 +0800 Subject: [PATCH 5/8] docs: add torrents/setTags --- WebUI-API-(qBittorrent-5.0).md | 25 +++++++++++++++++++++++++ 1 file changed, 25 insertions(+) diff --git a/WebUI-API-(qBittorrent-5.0).md b/WebUI-API-(qBittorrent-5.0).md index 54b62a7..8898f40 100644 --- a/WebUI-API-(qBittorrent-5.0).md +++ b/WebUI-API-(qBittorrent-5.0).md @@ -2459,6 +2459,31 @@ HTTP Status Code | Scenario ----------------------------------|--------------------- 200 | All scenarios +## Set torrent tags ## + +Remove all current tags and replace with the new ones. Requires knowing the torrent hash. You can get it from [torrent list](#get-torrent-list). + +```http +POST /api/v2/torrents/setTags HTTP/1.1 +User-Agent: Fiddler +Host: 127.0.0.1 +Cookie: SID=your_sid +Content-Type: application/x-www-form-urlencoded +Content-Length: length + +hashes=8c212779b4abde7c6bc608063a0d008b7e40ce32|284b83c9c7935002391129fd97f43db5d7cc2ba0&tags=TagName1,TagName2 +``` + +`hashes` can contain multiple hashes separated by `|` or set to `all` + +`tags` is the list of tags you want to set on the passed torrents. + +**Returns:** + +HTTP Status Code | Scenario +----------------------------------|--------------------- +200 | All scenarios + ## Remove torrent tags ## Requires knowing the torrent hash. You can get it from [torrent list](#get-torrent-list). From b5ff96ca227c851254a003411973b7b0c4f684d9 Mon Sep 17 00:00:00 2001 From: JackyHe398 on OldHome_main Date: Thu, 18 Jun 2026 22:48:59 +0800 Subject: [PATCH 6/8] docs: update returning properties for sync/maindata --- WebUI-API-(qBittorrent-5.0).md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/WebUI-API-(qBittorrent-5.0).md b/WebUI-API-(qBittorrent-5.0).md index 8898f40..e48fbea 100644 --- a/WebUI-API-(qBittorrent-5.0).md +++ b/WebUI-API-(qBittorrent-5.0).md @@ -1011,6 +1011,8 @@ Property | Type | Description `categories_removed` | array | List of categories removed since last request `tags` | array | List of tags added since last request `tags_removed` | array | List of tags removed since last request +`trackers` | object | Info for trackers added since last request +`trackers_removed` | array | List of trackers removed since last request `server_state` | object | Global transfer info Example: From 125e81ecd17316811478aa80f8ed9ad6e570e1a5 Mon Sep 17 00:00:00 2001 From: JackyHe398 on OldHome_main Date: Thu, 18 Jun 2026 22:50:22 +0800 Subject: [PATCH 7/8] docs: update returning properties of torrents/info --- WebUI-API-(qBittorrent-5.0).md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/WebUI-API-(qBittorrent-5.0).md b/WebUI-API-(qBittorrent-5.0).md index e48fbea..3552a49 100644 --- a/WebUI-API-(qBittorrent-5.0).md +++ b/WebUI-API-(qBittorrent-5.0).md @@ -1250,6 +1250,8 @@ Parameter | Type | Description `limit` _optional_ | integer | Limit the number of torrents returned `offset` _optional_ | integer | Set offset (if less than 0, offset from end) `hashes` _optional_ | string | Filter by hashes. Can contain multiple hashes separated by `\|` +`private` _optional_ | bool | Filter by private torrents. Return only private or non-private torrent when set to `true` or `false` respectively if set. + Example: From 4d2ad2482eefe775eb4bc9735a2535c9f68344e3 Mon Sep 17 00:00:00 2001 From: JackyHe398 on OldHome_main Date: Fri, 19 Jun 2026 00:44:17 +0800 Subject: [PATCH 8/8] fix typo --- WebUI-API-(qBittorrent-5.0).md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/WebUI-API-(qBittorrent-5.0).md b/WebUI-API-(qBittorrent-5.0).md index 3552a49..6d44267 100644 --- a/WebUI-API-(qBittorrent-5.0).md +++ b/WebUI-API-(qBittorrent-5.0).md @@ -2465,7 +2465,7 @@ HTTP Status Code | Scenario ## Set torrent tags ## -Remove all current tags and replace with the new ones. Requires knowing the torrent hash. You can get it from [torrent list](#get-torrent-list). +Remove all current tags and replace with the new ones. Requires knowing the torrent hash. You can get it from [torrent list](#get-torrent-list). ```http POST /api/v2/torrents/setTags HTTP/1.1