Overview
\nUpdates a download item based on the item's ID.
Sending a PUT request with valid items overwrites the previous items entirely, so use this endpoint with caution. Please make sure to read the restrictions below as they are important.
Restrictions
\n- \n
Item must be cached to update.
\n \nDoes not affect the cached database (or any other user's item).
\n \nName must pass validation:
\n- \n
Above 1 character long.
\n \nBelow 200 characters long.
\n \nCannot contain any non-url or non filesystem safe characters. (This is removed automatically).
\n \nCannot contain any leading or trailing whitespace. You can have spaces in the middle. (This is removed automatically).
\n \n
\nTags follow the same rules as the name.
\n \nAlternative hashes must be of MD5, SHA1, or SHA256.
\n \n
Authorization
\nRequires an API key using the Authorization Bearer Header.
\n","auth":{"type":"bearer","bearer":{"token":"{{api_key}}"},"isInherited":true,"source":{"_postman_id":"4244cdaf-ece6-4b6d-a2ca-463a3af48f54","id":"4244cdaf-ece6-4b6d-a2ca-463a3af48f54","name":"Main API","type":"collection"}},"urlObject":{"path":["{{api_version}}","api","webdl","editwebdownload"],"host":["{{api_base}}"],"query":[],"variable":[]}},"response":[{"id":"5e59ec52-f2bb-4f1e-a754-af5089696526","name":"Success","originalRequest":{"method":"PUT","header":[],"body":{"mode":"raw","raw":"{\n \"torrent_id\": 0,\n \"name\": \"string\",\n \"tags\": [\n \"string\"\n ],\n \"alternative_hashes\": [\n \"string\"\n ]\n}","options":{"raw":{"language":"json"}}},"url":"{{api_base}}/{{api_version}}/api/webdl/editwebdownload"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n \"success\": true,\n \"error\": null,\n \"detail\": \"Torrent edited successfully.\",\n \"data\": null\n}"},{"id":"4dbe62b4-836a-4a26-b02c-bda48868c601","name":"Fail INVALID_HASH","originalRequest":{"method":"PUT","header":[],"body":{"mode":"raw","raw":"{\n \"torrent_id\": 0,\n \"name\": \"string\",\n \"tags\": [\n \"string\"\n ],\n \"alternative_hashes\": [\n \"string\"\n ]\n}","options":{"raw":{"language":"json"}}},"url":"{{api_base}}/{{api_version}}/api/webdl/editwebdownload"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"INVALID_HASH\",\n \"detail\": \"Invalid hash: xxx. Hashes must be MD5, SHA1, or SHA256.\",\n \"data\": null\n}"},{"id":"16e3dc9f-9623-43d7-a7c8-4ea5f8c0d04c","name":"Fail NOT_OWNER","originalRequest":{"method":"PUT","header":[],"body":{"mode":"raw","raw":"{\n \"torrent_id\": 0,\n \"name\": \"string\",\n \"tags\": [\n \"string\"\n ],\n \"alternative_hashes\": [\n \"string\"\n ]\n}","options":{"raw":{"language":"json"}}},"url":"{{api_base}}/{{api_version}}/api/webdl/editwebdownload"},"status":"Conflict","code":409,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"NOT_OWNER\",\n \"detail\": \"Item not found or you do not have permission to edit this item.\",\n \"data\": null\n}"},{"id":"c98c1cb0-5fac-4d5c-a9e3-8529451a6f0a","name":"Fail NOT_CACHED","originalRequest":{"method":"PUT","header":[],"body":{"mode":"raw","raw":"{\n \"torrent_id\": 0,\n \"name\": \"string\",\n \"tags\": [\n \"string\"\n ],\n \"alternative_hashes\": [\n \"string\"\n ]\n}","options":{"raw":{"language":"json"}}},"url":"{{api_base}}/{{api_version}}/api/webdl/editwebdownload"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"NOT_CACHED\",\n \"detail\": \"Item is not cached and cannot be edited.\",\n \"data\": null\n}"},{"id":"4150a704-0dcf-41ca-8efb-3068f4b899f2","name":"Fail NO_CHANGES","originalRequest":{"method":"PUT","header":[],"body":{"mode":"raw","raw":"{\n \"torrent_id\": 0,\n \"name\": \"string\",\n \"tags\": [\n \"string\"\n ],\n \"alternative_hashes\": [\n \"string\"\n ]\n}","options":{"raw":{"language":"json"}}},"url":"{{api_base}}/{{api_version}}/api/webdl/editwebdownload"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"NO_CHANGES\",\n \"detail\": \"No applicable changes provided. Please provide at least one field to update.\",\n \"data\": null\n}"},{"id":"e0a0d402-e164-4548-b19c-04c935b4a716","name":"Fail NAME_TOO_LONG","originalRequest":{"method":"PUT","header":[],"body":{"mode":"raw","raw":"{\n \"torrent_id\": 0,\n \"name\": \"string\",\n \"tags\": [\n \"string\"\n ],\n \"alternative_hashes\": [\n \"string\"\n ]\n}","options":{"raw":{"language":"json"}}},"url":"{{api_base}}/{{api_version}}/api/webdl/editwebdownload"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"NAME_TOO_LONG\",\n \"detail\": \"Name must be less than 200 characters.\",\n \"data\": null\n}"},{"id":"d8d59313-bea7-459d-9fc3-7b700dfee25b","name":"Fail NAME_TOO_SHORT","originalRequest":{"method":"PUT","header":[],"body":{"mode":"raw","raw":"{\n \"torrent_id\": 0,\n \"name\": \"string\",\n \"tags\": [\n \"string\"\n ],\n \"alternative_hashes\": [\n \"string\"\n ]\n}","options":{"raw":{"language":"json"}}},"url":"{{api_base}}/{{api_version}}/api/webdl/editwebdownload"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"NAME_TOO_SHORT\",\n \"detail\": \"Name must be at least 1 character.\",\n \"data\": null\n}"}],"_postman_id":"d770d5df-390f-4670-b89e-d16e38ff22ba"}],"id":"533ea9ba-d6d6-42f2-af4b-1132d69054b3","description":"Overview
\nWeb Downloads are another use of TorBox. Adding links such as images, Youtube videos and more can be an easy way to download them and add them to your device. This API is practically the same as the Usenet and Torrents API.
\nAuthorization
\nFor all requests, you will need your API token which can be found on your TorBox settings page under the API key section. Simply copy or refresh the API token and use it in the API.
\nEndpoints /api/webdl
\n- \n
\nPOSTCreate Web Download/createwebdownload\n
\nPOSTControl Web Download/controlwebdownload\n
\nGETRequest Download Link/requestdl\n
\nGETGet Web Download List/mylist\n
\nGETGet Web Download Cached Availability/checkcached\n
\nGETGet Hoster List/hosters\n
Overview
\nSimply gets if the TorBox API is available for use or not. Also might include information about downtimes.
\nAuthorization
\nNone needed.
\n","auth":{"type":"bearer","bearer":{"token":"{{api_key}}"},"isInherited":true,"source":{"_postman_id":"4244cdaf-ece6-4b6d-a2ca-463a3af48f54","id":"4244cdaf-ece6-4b6d-a2ca-463a3af48f54","name":"Main API","type":"collection"}},"urlObject":{"host":["{{api_base}}"],"query":[],"variable":[]}},"response":[{"id":"ccdc8db3-754b-4c18-a718-daf02c56f136","name":"Success","originalRequest":{"method":"GET","header":[],"url":"{{api_base}}"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"date","value":"Thu, 16 Nov 2023 02:12:08 GMT"},{"key":"server","value":"uvicorn"},{"key":"content-length","value":"35"},{"key":"content-type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"error\": null,\n \"detail\": \"API is up and running.\",\n \"data\": null\n}"},{"id":"51f89ee9-332f-4816-941c-8f30b4ccc659","name":"Fail","originalRequest":{"method":"GET","header":[],"url":"{{api_base}}"},"status":"Bad Gateway","code":502,"_postman_previewlanguage":"html","header":[{"key":"Content-Type","name":"Content-Type","value":"text/html","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":""}],"_postman_id":"2781b110-d116-4e17-92d9-4146149aad95"},{"name":"Get Stats","id":"8ab7b908-f1d0-48ff-ad6c-77b6c65ccaf6","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{api_base}}/{{api_version}}/api/stats","description":"Overview
\nSimply gets general stats about the TorBox service.
\nAuthorization
\nNone needed.
\n","auth":{"type":"bearer","bearer":{"token":"{{api_key}}"},"isInherited":true,"source":{"_postman_id":"4244cdaf-ece6-4b6d-a2ca-463a3af48f54","id":"4244cdaf-ece6-4b6d-a2ca-463a3af48f54","name":"Main API","type":"collection"}},"urlObject":{"path":["{{api_version}}","api","stats"],"host":["{{api_base}}"],"query":[],"variable":[]}},"response":[{"id":"d2adf686-5656-4017-ab43-51e9af43eafe","name":"Success","originalRequest":{"method":"GET","header":[],"url":"{{api_base}}/{{api_version}}/api/stats"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"date","value":"Thu, 16 Nov 2023 02:19:34 GMT"},{"key":"server","value":"uvicorn"},{"key":"content-length","value":"103"},{"key":"content-type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"error\": false,\n \"data\" : {\n \"total_users\": 0,\n \"total_servers\": 0\n },\n \"detail\": \"Stats retrieved successfully.\"\n}"},{"id":"dc80c465-2a9a-4202-84a4-554bac943424","name":"Fail DATABASE_ERROR","originalRequest":{"method":"GET","header":[],"url":"{{api_base}}/{{api_version}}/api/stats"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"DATABASE_ERROR\",\n \"detail\": \"There was an error getting the stats. Please try again later.\",\n \"data\": null\n}"}],"_postman_id":"8ab7b908-f1d0-48ff-ad6c-77b6c65ccaf6"},{"name":"Get Changelogs RSS Feed","id":"5a13f7e5-1166-4758-9d67-acac18ed3bac","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{api_base}}/{{api_version}}/api/changelogs/rss","description":"Overview
\nGets most recent 100 changelogs from https://feedback.torbox.app/changelog. This is useful for people who want updates on the TorBox changelog. Includes all the necessary items to make this compatible with RSS feed viewers for notifications, and proper HTML viewing.
\nAuthorization
\nNone needed.
\n","auth":{"type":"bearer","bearer":{"token":"{{api_key}}"},"isInherited":true,"source":{"_postman_id":"4244cdaf-ece6-4b6d-a2ca-463a3af48f54","id":"4244cdaf-ece6-4b6d-a2ca-463a3af48f54","name":"Main API","type":"collection"}},"urlObject":{"path":["{{api_version}}","api","changelogs","rss"],"host":["{{api_base}}"],"query":[],"variable":[]}},"response":[{"id":"db8592cd-04b8-470b-9eda-d9622a29733d","name":"Success","originalRequest":{"method":"GET","header":[],"url":"{{api_base}}/{{api_version}}/api/changelogs/rss"},"status":"OK","code":200,"_postman_previewlanguage":"xml","header":[{"key":"Date","value":"Wed, 02 Apr 2025 09:19:20 GMT"},{"key":"Content-Type","value":"application/xml"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Vary","value":"Accept-Encoding"},{"key":"Content-Encoding","value":"gzip"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Report-To","value":"{\"endpoints\":[{\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=1YMKfrXr79muRmpTJw1UTWi%2FoEecDGmCn6VZMN4qWHHSsu7FWcTZlvRndrXnjhPN0P54WvKpJfySPXyhJkazs4nVF068Z5BybXxFfZ%2F9rDMsasLROEOiMuFZwmNHF6iJ\"}],\"group\":\"cf-nel\",\"max_age\":604800}"},{"key":"NEL","value":"{\"success_fraction\":0,\"report_to\":\"cf-nel\",\"max_age\":604800}"},{"key":"Set-Cookie","value":"__cflb=02DiuEMTxkdpXASqgPCVFpcRqFW2o2goshyFe9xzR8GDz; SameSite=None; Secure; path=/; expires=Thu, 03-Apr-25 08:19:20 GMT; HttpOnly"},{"key":"speculation-rules","value":"\"/cdn-cgi/speculation\""},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"929f3e756ab4d1a3-MCI"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400"},{"key":"server-timing","value":"cfL4;desc=\"?proto=TCP&rtt=50399&min_rtt=49994&rtt_var=19037&sent=5&recv=5&lost=0&retrans=0&sent_bytes=2805&recv_bytes=625&delivery_rate=82089&cwnd=252&unsent_bytes=0&cid=21916ec908e04d6c&ts=471&x=0\""}],"cookie":[],"responseTime":null,"body":"\nOverview
\nGets most recent 100 changelogs from https://feedback.torbox.app/changelog. This is useful for developers who want to integrate the changelog into their apps for their users to see. Includes content in HTML and markdown for developers to easily render the text in a fancy yet simple way.
\nAuthorization
\nNone needed.
\n","auth":{"type":"bearer","bearer":{"token":"{{api_key}}"},"isInherited":true,"source":{"_postman_id":"4244cdaf-ece6-4b6d-a2ca-463a3af48f54","id":"4244cdaf-ece6-4b6d-a2ca-463a3af48f54","name":"Main API","type":"collection"}},"urlObject":{"path":["{{api_version}}","api","changelogs","json"],"host":["{{api_base}}"],"query":[],"variable":[]}},"response":[{"id":"5fbdac48-01b2-47a4-a400-059b32285faa","name":"Success","originalRequest":{"method":"GET","header":[],"url":"{{api_base}}/{{api_version}}/api/changelogs/json"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 02 Apr 2025 09:20:56 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Vary","value":"Accept-Encoding"},{"key":"Content-Encoding","value":"gzip"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Report-To","value":"{\"endpoints\":[{\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=nN%2FIO4%2Fb3NEzII9SEQApYiemv2XvVn%2FrCdJUoC1qV4%2FvLJAfjqD8QWyOHy0NS9Gq6AGkyPmBN5Zq5SbM1ZNYuxzARmL3xBzwiC0%2BZKwj9%2F6IDRan6AuAu381uumAl8xE\"}],\"group\":\"cf-nel\",\"max_age\":604800}"},{"key":"NEL","value":"{\"success_fraction\":0,\"report_to\":\"cf-nel\",\"max_age\":604800}"},{"key":"speculation-rules","value":"\"/cdn-cgi/speculation\""},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"929f40cab8afd313-MCI"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400"},{"key":"server-timing","value":"cfL4;desc=\"?proto=TCP&rtt=50669&min_rtt=50585&rtt_var=19138&sent=5&recv=5&lost=0&retrans=0&sent_bytes=2805&recv_bytes=688&delivery_rate=80060&cwnd=252&unsent_bytes=0&cid=32512fb0e0a369e8&ts=749&x=0\""}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"error\": null,\n \"detail\": \"Successfully retrieved changelogs.\",\n \"data\": [\n {\n \"name\": \"v7.1.3\",\n \"html\": \"API
Allows sending authentication to the Web hosters listing endpoint for live data and accurate representation of usage over daily use. API DOCS.
Allows redirecting download links using ?redirect=true. This is good for a lot of automations which created download links and refreshed them to keep them alive, which is considered abuse. Instead you can now give a permanent URL such as:
https://api.torbox.app/v1/api/torrents/requestdl?token=APIKEY&torrent_id=NUMBER&file_id=NUMBER&redirect=true. API DOCS.
Web Downloads/Debrid
Adds Send hoster. This is a modern file hoster which is very popular, which TorBox now supports with high speed downloads, all included in your TorBox paid subscription.
Adds Pillowcase.su hoster. This is a popular file hoster which is mainly geared towards open source music.
Adds SwissTransfer hoster. This is a popular temporary file hoster which can be slow to download from for users in some countries. This can make TorBox an excellent choice for downloading SwissTransfer files as they are downloaded extremely fast.
Thanks to our partnership with Cobalt.tools you can now download from YouTube reliably, as well as 20+ more sites that they offer!
Currently no download progress is shown on the dashboard, and size will start out at zero, but as it downloads the size will update, being a way you can see that things are moving. They are working on this, and it will be fixed soon.
Fixes TurboBit downloads.
Fixes Bunkrr downloads.
Service
In the case where a Usenet download’s name is its hash, while the filename is correct, the name will be renamed to the file name, bar any extensions. This will solve some issues with obfuscation.
Web Downloads/Debrid
Adds support back for Terabytez which was previously removed months ago due to the migration to the new system.
Adds ability to download from HAnime. This is a popular hentai streaming platform which you can now download to TorBox. Simply take a the webpage link of the video you want downloaded and it will be added to your TorBox. There is no download status for this hoster.
Adds support back for HentaiFoundry which was previously removed months ago due to the migration to the new system.
Adds support back for 4Shared which was previously removed months ago due to the migration to the new system.
Adds support back for HexUpload which was previously removed months ago due to the migration to the new system.
Fixes Nexusmods downloader edgecase where some mods return file sizes of null from the API which prevents it from being downloaded.
Fixes Buzzheavier downloads as the website has changed.
Fixes edge case with Turbobit links including parameters which are not handled.
We are still slowly adding back the previously removed hosters and even more!
Service
Notification actions created from completed Usenet download now correctly sends you to the right download page.
Search API
Better handling of Prowlarr magnets and torrent files.
Prowlarr search engines now show “user_search” as true. This is useful for the Stremio addon to properly display.
Web Downloads/Debrid
Added dedicated Dropbox downloader as the previous one could only handle media files such as video and audio. This one can handle all file types.
Added support for APKAdmin hoster. Simply submit the download page of the file you want to download and it will download it, bypassing any ads, popups, or wait times!
Added support for Nexusmods hoster. Simply submit the mod or collection you want downloaded and it will download at max speed (no waiting times or slow downs or limit to concurrent downloads)!
WebDAV
Deleting a WebDAV folder will delete it from your TorBox account. This is useful for users, tools or automations which want to control downloads from the WebDAV! (FTP parity coming soon).
Stremio Addon
Handles edge-case where links would not get encoded properly and be routed elsewhere. This only happened with select links from Prowlarr user search engines.
Website
Fixes settings page to disallow the following while it is still loading data:
Copying API key
Getting a new API key
Viewing subscriptions (will not show placeholder)
Viewing time left on account (will not show placeholder)
Stremio settings do not allow for setting bad changes.
Cache settings must have an option selected.
Quality, Resolution and Language must include the “Unknown” option.
The “Only show streams larger than size (GB)” setting must be less than the “Only show streams smaller than size (GB)” limit.
The “Only show streams smaller than size (GB)” setting must be at least 1, and more than the “Only show streams larger than size (GB)”
New popup with discount for Free users to upgrade to a yearly plan on new torrent being added.
Fixes RSS page live data from causing the page to error out if a request fails.
Removes Sellix CDN script from site.
Free users now use session tokens for authentication with the API rather than API keys as they are no longer able to access the API.
Adds new $1 Pro Trial button to dashboard for Free and never before subscribed users. This allows you to use Pro in full for 24 hours for only $1!
Adds WebTorrent checker to tools page as a direct link so users can quickly verify how many seeders and peers their torrent has. We will eventually be building this directly into the browser in the tools page.
Notifications can now have actions!
Actions are buttons that do an action corresponding to what the notification is about. For example, if there was an error and you need to contact support to get it resolved, the action button will open the support modal to easily contact support. If a torrent finished downloading, it will give you a direct link to the download page of the files.
This feature is extremely powerful, and we will be adding more actions corresponding with notifications in the future.
Cloud transfers, such as to Google Drive, OneDrive, 1Fichier, and GoFile can be cancelled in the middle of the transfer. This allows you to stop transferring at any point in the process and it won’t be uploaded to the cloud.
Stremio Addon
New background for metadata that cannot be found on the Your Media section. Not a lot of people will see the new background but it is awesome. You can find the image here. Put this as your wallpaper!
Stream lists now show the tracker the search result was from. This is useful for determining what tracker or indexer it was from so you can make better decisions for choosing streams.
Stream lists now show if the file was from a user search engine or not. It will look like
TorBox (User Search) (Instant) (1080p)for a 1080p cached result from the user’s search engine. Pair this with the above tracker viewer, and you know exactly where a stream is from!A new error video plays when you are out of slots. This can happen periodically and to the average user it looks like there was a bug in TorBox, when really, their account is out of slots to download the torrent in the first place.
Web Downloads/Debrid
Allows downloading direct Buzzheavier links such as in the format
https://buzzheavier.com/dl/XXXXXXFixes downloading from Archive.org. Some links weren’t shaped properly when copied from the Archive.org site.
Downloads from Archive.org now show download progress. Previously it would look stuck as we didn’t have reliable status updates.
Baidu downloads have been made more reliable. Links were getting stuck in storage filling it up, which no longer occurs.
Fixes MegaUp downloads.
Fixes Mediafire downloads.
Fixes 1Fichier downloads with bad characters in the name (Non-UTF8).
API
Cancelling in progress transfer jobs is possible now through the API. API DOCS.
Submitting names to the API are now properly handled when creating Usenet and Web Downloads.
Webhooks sent from the API to user’s configured webhook URL now use the title as the webhook type, such as “Download Ready” to “download.ready” for handling properly in webhooks. This will be documented soon.
Proper API messages when a free user submits their API key to the API.
Service
Fixes some RSS feed links which download a .rss file, or a .xml file rather than returning the RSS feed data directly as content.
Subscriptions with Patreon now fixed.
Usenet files are now normalized to allow for usenet files to be properly cached. When an NZB is added from the same tracker, and is the same file, even from different accounts, it will be cached if actually cached.
Cloud transfers now are more reliable due to using CDN rather than “local storage” files, which can be slow, or have other issues.
More reliable processing.
Fixes torrent ownership. If, for example, 2 users add the same torrent at the same time, one of the users will be the owner of the torrent, rather than duplicates being created. This lead to problems with the database and qBittorrent not being synced, especially with private torrents, where it is far more important.
Cloud transfers should start sooner (instantly), rather than taking minutes or even hours to start due to sharing a queue with other high traffic queues, which could get stuck in the back for a long time.
Torrent updates should be more full on the dashboard with no issues with malformed data.
Website
Added UI section labeled “Search” in the settings. This is where you can access the new Bring Your Own Indexer (BYOI as the community has been calling it) settings. This allows you to add your own indexers or trackers using the NZBHydra2, Jackett or Prowlarr self-hosted apps.
This allows you to get personalized torrents and Usenet results from your own trackers, removing reliance on TorBox’s own search indexers and providers.
This also allows you to stream private torrents from apps like Stremio which use TorBox’s search engine. This is a never before seen feature.
Like mentioned, it works with torrents and Usenet and adding new search engines is very easy.
It works using the API too, so you (and developers) don’t have to do anything extra to use it with existing apps that already use the TorBox Voyager search engine.
Shows the available indexers that it will use.
Added a manual switch in the Search settings for using the BYOI feature in Stremio, as not everyone may want it in Stremio, as it may create longer loading times. This is off by default.
Added a switch in the Stremio settings for using the legacy “Your Media” in the Stremio addon discover page. (More on this in the Stremio section).
Added a switch in the Stremio settings for sorting what type of streams are shown first. You can now choose whether you want Usenet or torrent results first in the list.
Added a switch in the Integration settings for WebDAV labeled, “WebDAV Use Local Files”. This allows you to use the CDN, or not when downloading from the WebDAV. Depending on how you use the WebDAV service, it may be necessary to enable this setting. More information can be found on the settings page.
Fixed mass deleting queued downloads in the settings page.
Adds back Crypto payments which are now being processed through NowPayments.io due to Sellix.io being taken down.
The dashboard now properly updates when you “Stop Seeding” a torrent.
Added clarification about per link size limits on the Hosters page.
Makes it easier to long tap on an item on the dashboard for iOS mobile devices which wanted to select text rather than hold on an item. It will now show the context menu more reliably.
All downloads now show a distinguished “Cached XXX ago” and “Created XXX ago”. This is to better tell how long ago an item was cached, while also not messing up the dashboard.
Stremio Addon
The Stremio addon can use the BYOI feature recently introduced. Make sure you enable it in the settings.
New “Your Media” section (discover page).
This now shows posters relating to the media rather than basic TorBox posters with text.
Multiple media downloads which relate to the same media will be placed together in the Your Media section. When clicking on a Your Media item, it will now show the proper listing for content based on Season and Episode (if TV) or list the watchable files inside of the media download if a movie.
It now shows full metadata for download items including year, description and even rating.
NOTE: THIS REQUIRES YOU TO RE-INSTALL YOUR TORBOX STREMIO ADDON TO WORK PROPERLY.
“Your Media” in the stream selection page is now more reliable and works even if the torrent/Usenet files are not named properly, it will still match in most cases.
You can now sort by torrent or Usenet in the streams selection page. This allows you to show either torrents or Usenet downloads first. This can be useful, especially for Pro users who only want to stream Usenet downloads.
The addon now uses CDN selection when streaming. Previously it only used the EU when streaming if on the default (Auto) setting. Setting manually used the CDN.
Better streaming performance, less buffering, and shorter start times for most users.
Play next episode now works properly in the addon allowing users to get the Stremio popup for getting the next episode, even inside of “Your Media” listings.
Usenet items now properly show as cached if another user has them cached.
WebDAV
Speed improvements regarding listing files. It no longer requires the filesystem to list files meaning it is very quick due to using the database only. Users with large libraries should no longer time out when viewing their files.
Allows using the CDN when downloading files. This increases reliability, and heavily increases download speed especially for users requiring a CDN to download quickly. This makes streaming over the WebDAV insanely quick now.
Your may get 429 errors when downloading large folders. This is due to the connection limit and request speed when downloading many files at the same time from our CDN which is rate limited and connection limited. We recommend sticking to 1 connection in these cases.
Search API
The search API now includes Torrentio when searching for torrents via ID. Torentio has many good sources and is very fast, so it is being used as a backup.
Parameter to enable user search engines when searching the API,
search_user_engines. This will increase the amount of time taken (as you are waiting for responses from more places, and disable caching on any results. API DOCS.This uses the user’s search engines which they have configured in their settings to search for the torrents/Usenet requests you specify. All work with ID or query.
Minor speed optimizations when searching for torrents.
Web Downloads / Debrid
Fixes Mediafire downloader due to Cloudflare protections.
Fixes NHentai downloader due to Cloudflare protections.
Fixes Qiwi downloader due to Cloudflare protections.
Adds Bunkr downloader. A popular filehoster primarily used for pornography. Known for having lots of ads on its pages, so using TorBox to reliably and safely download from Bunkr is great.
Adds MegaUp downloader. A popular filehoster. Known for having lots of ads and malware on its pages, so using TorBox to reliably and safely download from MegaUp is great.
Adds Anna’s Archive downloader. This is a popular library file hoster with the internet’s largest collection of books freely available to download. TorBox downloads these files extremely fast, which is usually limited to donating users to the site.
Makes Baidu downloader more reliable.
Baidu does not show download speeds or any download status.
Makes DDownload downloader more reliable.
Fixes Datanodes downloader due to new changes.
Better status updates when something fails due to Cloudflare protections.
Overall better reliability of the web downloads system.
Fixes Filer downloader.
Fixes SpankBang downloader.
Fixes Coomer downloader.
Pixeldrain lists and directories can now be downloaded from and added to TorBox.
Adds many more supported hosters.
NOTE: We are aware of Mega.nz downloader issues. This has been disabled for time being. They now disallow pretty much all 3rd party apps from using their API, even their own CLI. We are working on a fix. Please bear with us. You can read more about this issue here, here and here.
Service
Zip downloads now use the CDN making them extremely reliable and fast. Even large downloads with hundreds of files and folders will start downloading relatively quickly and at good speeds. It is CDN based, meaning you will download the zip from the closest server to you (or based off of your CDN settings) making zips very good rather than using the WebDAV or FTP.
We introduced our Beta US CDN. If this test goes good, we will continue expanding the US CDN with this server provider. All new downloads will go to the US CDN as well as the EU CDN as replication.
RSS Feeds now properly update based off of the time given.
Usenet and Web Downloads will now be queued if you are out of active slots to be downloaded later.
Notifications will now tell the reason why a Usenet download failed inside of the message.
Better payment errors.
Pro users are now able to add downloads up to 1TB in size from the previous 500GB!
Download links are now valid for 3 hours before expiry rather than 1 hour.
Fixes some torrents still seeding when added through the Stremio addon if the user’s option is set to “Never”.
Properly sends an email when the user’s account is deleted to confirm deletion.
Cached web downloads will not show download progress.
Seeding torrents properly stop seeding at (or near) their specified seeding time.
API
The API now distinguishes a “cached_at” date and a “created_at” date. The “cached_at” date is to determine how long ago an item was cached, while “created_at” determines when a download was added to a user’s account.
FTP
Fixes some filenames not showing properly and creating a recursive file structure due to not detecting it is a file/folder properly.
Since we re-did RSS feeds, we also had to redo queued downloads as those were also becoming a problem, especially with the increase in new queued downloads (over 1 million), and at the beginning I (Wamy) did not foresee millions of records in a single table, so there became many issues which sprung about due to not being optimized for said millions of records. Luckily the fixes were somewhat simple, and the new features easy to add.
Website
Adds the ability for different types of queued downloads to show up. This includes Usenet and even web downloads being able to be queued. Previously these would simply error, now they can be queued and used just as before.
Service
Queued downloads will be added on time (every hour), as before they would get delayed by minutes, hours and even days, which is not a good experience, especially if you have open slots you want to use.
SDK
Updates all SDKs to the latest version to reflect changes in the API.
API
BREAKING CHANGE: Removes the queued downloads routes at
/torrents/controlqueued, and/torrents/getqueued. This was due to queued items needing their own route, rather than only being limited to the torrents endpoint. The routes are practically the same with a little more options, so if you are using these endpoints (basically nobody), then you can simply change the route and it will be all good!Introduces a new route,
/queued, which is where queued endpoints will now live. This is to allow future expansion, and stop any possible confusion when wanting to use queued Usenet downloads or web downloads for example. API DOCS.Adds the “as_queued” parameter when creating a Usenet download. This way you can keep it in your queued and the system will add it eventually (gets checked every hour). API DOCS.
Adds the “as_queued” parameter when creating a web download. This way you can queue up lots of limited hosters for example, and the system will add each one in time (gets checked every hour). API DOCS.
The RSS update! This update is specific to the RSS feed system, which has been left untouched for quite some time now. We have been going through and listening to what our users have been wanting, and an improved RSS feed system has been something that has been desperately needed. In short, we added compatibility with Usenet and web download RSS feeds, better reliability, and more status views so you (and us) can see exactly what is wrong with your RSS feed should issues arise! Read the specific details below.
Website
Adds new RSS feed UI, which allows you to view all of the RSS feed items associated with an RSS feed. This allows you to view what has been scraped, downloaded, or what has been errored out.
You can also click on the name for each item and get the associated file from the RSS feed source.
Adds RSS feed status UI, allowing you to see exactly what is happening with your RSS feed at that exact moment, as well as see any possible issues that TorBox has had while scraping or downloading your RSS feed.
The RSS feeds page has been updated and now shows a bunch of new information, and auto updates, and is highly responsive with changes.
You can now specify 2 new options when editing or adding a new RSS feed.
You can now specify the RSS Feed Download Type being a torrent, usenet, or web download RSS feed. This allows you to choose how scraped items are added to your TorBox account based on the RSS feed.
If the RSS feed type is of torrent, you can specify seeding settings, which are the same as the standard torrent seeding settings. This allows you to choose, per RSS feed, if they seed or not. This can be helpful for adding a lot of items at a time to the cache, or if you are adding from a private tracker for example.
Service
Completely rewritten RSS feeds with compatibility with Usenet, and even web downloads!
This rewrite (should be taken lightly) adds a ton of new features and makes it easier to see what exactly is going on with your RSS feed.
This also makes it so that it actually scrapes on time, rather than being delayed for minutes or even hours at a time.
RSS feeds now allow you to view their associated items, meaning that you can easily view and possibly debug any issues with an RSS feed and its items. Every item comes with a status and a status message.
API
New endpoints for retrieving RSS feeds and their associated items. This allows you to fully use and control RSS feeds now.
Wow, writing this, I don’t even know where to begin. Version 6 of TorBox has been something that we have been desperately needing, and with our recent explosion of users, something that has been even more necessary. Our last change log was v5.0, on November 10th, 2024, which as of posting this update has been over 3 months ago. So much has happened in the past few months. Just because no updates have been posted, doesn’t mean we haven’t been just twiddling our thumbs like some people think.
Website
Adds searching to integrations page. This makes it much easier to find the integration(s) you are looking for!
Adds CDN selection settings in the settings page under Integration Settings.
Fixes Integration Settings tab on mobile displays being centered.
Adds confirmation when attempting to cancel a subscription.
Allows users to manage subscriptions by clicking “Manage Subscription”, which takes you to the correct place to manage your subscription.
You can now view all of your previous TorBox transactions under the Account section of the settings page, labeled “Past Transactions”.
Hosters page for viewing the current status of our newly rewritten hosters system. This is dynamic and updates every 30 seconds, and always has the most current information.
You can also search this page.
The dashboard now updates properly and is much more responsive, including deletions, additions and updates.
Relay
The relay was rewritten internally to better handle the load of thousands of torrents all getting updates at the same time.
Previously the client (the website or other application) was responsible for requesting updates from the qBittorrent. Once you had thousands of requests going to only a few dozen nodes every single second, things got overloaded quickly, and as a result, it looked like downloads never started or were extremely slow, even if they were downloading lightning fast.
Instead we now have a dedicated process that uses what the qBittorrent webUI uses called Sync. It massively reduces the load on both the database and the servers themselves by only getting the updated data of the torrent, rather than the entire torrent object which was bandwidth and time costly.
Telegram Bot
By sending
/subscribeto the Telegram bot, you can now pay for a TorBox subscription using Telegram Stars as a payment method. Telegram Stars can be purchased directly from Telegram using a debit or credit card, Apple Pay or Google pay wherever you use the Telegram app. This allows users who may not be able to pay with standard methods, to be able to pay for and use a premium TorBox subscription.
Service
Allows privacy emails such as those from duck.com or simplelogin.com. This was previously blocked due to an API change from our email checking provider.
The speed test servers have been re-enabled. These were disabled previously to prevent additional load on the servers.
Payments are now given 31 days, rather than 30 to account for all months. This was causing users who paid in December to have their accounts lapse.
Completely rewritten our Hosters system rather than using JDownloader2 internally. We love JDownloader2 and use it personally, but it has scale issues which required us to completely do a 180 turn and write an API from the ground up, which allows us so much flexibility, and keeps us from relying on a 3rd party to keep our services running.
With this change we have already rolled out some of the most popular hosters available, as well as ones that have never before been seen on any debrid service!
New servers and networking now makes seeding and downloading much better and faster due to changes in network allowing torrents to find peers much faster and more than previously.
Changes to our routing system and how CDN and files are found on our servers.
This completely removes any issues with propagation across servers and waiting for files to be available on all servers. Instead the API will calculate and find the closest server to you (or your selected CDN) if it has the file. Otherwise it will just pick the only server with the file.
This also allows more direct connections as we send you to the exact server with the file, rather than possibly proxying the file across servers, introducing unreliability and slower speeds than what is technically possible.
This allows us more flexibility as well as helps in debugging, as every link is the same. If, for example, you run into slow speeds, you can simply send us the link and we know exactly what server is having the issues.
API
A dynamic and updating debrid hoster list has been made public for apps use. API DOCS. This can be used for status pages and the like. One has already been implemented on our Discord server using this API. Thanks Midnight!
CDN selection from settings overrides all settings passed.
Download links are cached in memory for a short period of time after creation to reduce time of the request down about 80%! These savings are also passed onto everything that requests a download links from the API saving time for all requests after the first.
Stremio Addon
Thanks to one of our developers, Runage, discovered that Stremio creates a new request to the API everytime you seek or click the play button on a piece of media. Runage advised us to cache the download link inside of the Stremio addon, so that if a user seeks or resumes media, it can be extremely fast. We have implemented this, and seeking is now much faster!
We are in the process of completely rewriting our Stremio addon to be the fastest and most feature complete addon available!
Website
Users now get rate limit errors when adding too much via the Dashboard.
Virtualizes search results list so that there is no lag when searches return a lot of results (>200).
Adds referral data to subscriptions page so you can see:
The number of referred accounts that currently use your code.
The total number of purchases your referrals have made using your code.
The total number of days earned by your referrals using your code.
The total amount of money or value you have theoretically saved by referring.
Shows success notification when deleting an item from the dashboard.
Puts integrations page behind authentication meaning you have to be logged in to view it.
Changes wording of a lot of sections on the main pages.
Fixes not all search results showing on search.
Deleting an account now requires a confirmation code to be entered which prevents accidental deletions. This was a highly requested and extremely necessary fix.
Brand new settings page layout!
Adds subscription section to account settings section so that you can manage your subscriptions right from the TorBox website.
Adds section for deleting all of your TorBox downloads. Good to purge your account.
API
API now returns normalized dates in the format:
%Y-%m-%dT%H:%M:%SZ. Previously, this was causing issues with some integrations having to write custom parsers as TorBox would include nanoseconds in response times. This also standardizes the entire API to use UTC time.Adds remark about dates on Main API docs.
Updates rate limiting for creating downloads. More information at Main API docs.
TorBox now keeps track of how many purchases you have referred, and how many users currently use your referral code. This information can be found at the new route
/users/referraldataYou can send an IP to the
/xxx/requestdlroutes using the parameteruser_ipwhich will allow you to basically choose the CDN that your user will receive. This is useful for integrations where a main API is making all of the requests, but you still want the user to use the CDN. API DOCS.On the routes
/xxx/mylistthe API only returns a 404 for empty requests if theidparameter is given.BREAKING CHANGE: On the routes
/xxx/checkcachedthe API now returns an empty object or list if the cache returns nothing. (Yes we will be keeping this endpoint, it’s not going anywhere).Adds Baidu, Twitch, and HexUpload to supported in JDownloader2.
Upped rate limits to 60/hour for all creation endpoints (
/torrents/createtorrent, etc).You can now request confirmation codes for all sorts of future uses. Right now, it is being used to verify account deletion requests, it will be used for verification of accounts for dangerous things. API DOCS.
Allows force starting a queued download from the API (will be added to the UI in coming updates).
Service
Allows RSS feeds to include links in
<enclosure url=someurl.com/>. Previously we only allowed links in<link>someurl.com</link>.Fixes modifying RSS feeds.
Usenet downloads now download at over 800MB/s.
Processing downloads are now much faster thanks to insanely fast transfers to our storage servers (over 3x improvement from 250MB/s to nearly 1000MB/s).
We are now using our new homemade CDN system to serve new or very popular files, which should increase the download speeds from the majority of our user base.
Users in the west side of the world (United States of America, Brazil, Argentina, Canada, etc) now get access to our new CDN system. If the file meets all of the criteria, it will be available to download from https://storage-hyperdrive.west.torbox.app.
Users in the eastern side of the world (Japan, Hong Kong, Singapore, India, Bangladesh, Saudi Arabia, United Arab Emirates, China, Thailand, Sri Lanka, Pakistan, etc) now also get access to our new CDN system. if the file meets all of the criteria, it will be available to download from https://storage-hyperdrive.apac.torbox.app.
We are also throwing countries such as New Zealand, Australia in this list for the time being as they users in these countries will benefit from the APAC region (as it’s closer than the EU).
This does not affect download speeds for files served over WebDAV, FTP, Tinfoil, or any other download method not part of our web storage system (https://storage.torbox.app).
This also does not affect zip downloads such as those from https://storage-zip.torbox.app.
This is completely automatic, and already works with all integrations that use the request download API endpoint, and is based on the client’s region as determined by Cloudflare.
If you are not in these regions, such as in the EU, you will still be served files from https://storage.torbox.app, from our servers in the Netherlands, no CDN is needed for you!
Normal download speeds from TorBox should be much faster! We have noticed differences at about 10-15% increase (from https://storage.torbox.app links).
The “file could not be retrieved” propagation error should be now completely eradicated! As soon as a download is marked as “Ready to Download” it will actually mean that, ready to download!
TorBox now supports downloading from Twitch and Baidu! Simply put in a Twitch or Baidu link (and an optional password), and it will download like normal (no status updates right now).
Much more reliable debrid downloads. Previously we were seeing failures at up to 30%, now we have seen it down to under 2%. Failures can be due to many different conditions.
Faster debrid downloads. Downloads should now start downloading instantly. Previously there was a queue, and if there were a lot in front of yours it could take a long time to begin. We have now fixed this issue.
A standard notification is now sent after a purchase was made with a referral code to the user purchasing (the referee).
Storage files now reset their expiry every request to allow for things like pausing for an hour and such.
Allows more than 1000 torrents to be requested at one time, up to 10000. This allows you to show 10000 on the webdav.
Better reliability during processing to reduce failed transfers.
Payment confirmations now have a dedicated email so that you know for sure your payment has been processed (along with the standard notifications).
Torrents are now checked for illicit content, such as CSAM.
A dedicated email is now sent when your account is deleted.
Enables limits for specific debrid hosters. This allows for us to better manage abuse of our systems.
Stremio Addon
Slightly optimizes searching speeds.
Torrent searches now includes searches from Zilean.
FTP
Fixes logging into FTP with capitalization in the email.
Search API
Torrent searches now include data from DebridMediaManager, thanks to Zilean.
Discord Bot
The Discord bot is now a Discord verified bot!
Speed Test
The speed test page now includes test files for the US and Singapore CDN’s.
Search API
Searches by query should be a lot more accurate when searching titles.
Website
Optimized the dashboard to reduce lag with dashboards that have a lot of downloads that get updates.
Adds referral banner on subscription page.
Better explanation of referrals on the subscription page.
Adds TorBox partners site to footer.
Adds StremThru Integration to integrations page.
Adds setup guide for Kodi POV addon to integrations page.
API
On the
/mylistendpoints, if there are no results for the request parameters, it will give a 404 with a specific error, instead of a 200 and success response.Adds new Vendors API. This is still very incomplete and should not yet be used. API DOCS.
Service
Fixes uploading to OneDrive is user specifies a folder.
New TorBox Partners site. This is where you can sign up to become a vendor for TorBox, and even create your own TorBox experience, all using TorBox’s servers. More information about that coming soon. Currently not in full service, although, you can sign up to become a partner already.
Fixes downloads with some special characters in the name from properly processing.
v4.9 is easily our largest quality of life update of the year! We listened to your complaints, feature requests and issues, and decided to fix and implement nearly every one of them! The biggest feature request so far has been our search. Lately you would have a hard time finding exactly what you needed, with the biggest issue being by far, the torrent search. We decided to team up with Orion, who specializes in exactly that, to provide our searches for us.
Stremio Addon
“Your Media” in stream list selects all files that match, rather than just the first, which led to issues.
Fixes double (and triple) adding of torrents and Usenet downloads inside of the Stremio addon! This was an issue that affected nearly every addition of non-instant downloads, and was taking up a slot.
For those of you curious, the issue was that Stremio always sends a
HEADrequest when getting video (for getting pre-loaded information about the file), which was interpreted in our Stremio Addon as requesting the video over again. We simply denyHEADrequests and it works fine. Stremio will still work without theHEADrequests as the video information is delivered on success of theGETrequest (which we actually care about). You can read more about the issue here.
Adds Dutch language filter.
Stremio now relies on the Search API which uses TorBox’s new Voyager search engine.
Website
Usenet credentials are now a little smarter, and won’t allow you to copy asterisks as your password anymore. It will also give an error when attempting to copy your password if not reset.
Adds Seanime Integration to integrations page.
Adds POV Kodi Addon Integration to integrations page.
Adds Jacktook Kodi Addon logo to integrations page.
Removes Dropbox Integration from integrations page.
Adds Orion Integration to integrations page.
Removes Dropbox Integration from download page.
Adds torrent file downloading. This allows you to download the files as a torrent, meaning you can use it through a seedbox or other applications that use .torrent files.
1Fichier and GoFile integrations now show upload progress. This is helpful for monitoring their progress, as they used to only show 0% until completion or failure.
Removed VLC “Open In Player” option due to the lack of deep linking.
Hides Stremio “Open In Player” option on mobile devices due to it not being supported on mobile, only desktop. Read this issue for more.
Adds filter for Dutch language for Stremio in the settings.
Torrent and Usenet search both got an upgrade! Uses TorBox’s new Voyager search engine, which uses Orionoid.
Searches are now restricted to only paid users. This is due to the cost and quality of Orionoid, and our partnership with them.
Searches now show if the torrents are cached, right in the UI meaning you can pick instantly ready to download files.
Searches now also show if you already have the file in your TorBox account. This makes picking new downloads much easier and takes out the guesswork.
Service
Removes Dropbox integration due to production level status requiring approval. The app was attempted to be verified but denied, disallowing any further attempts due to possibility of piracy.
If a torrent contains a video file, the entire download will not be zipped. This is to prevent issues with Stremio and other streaming services connected to TorBox.
Allows
HEADrequests on download files.Speeds up processing times.
Only calculates the MD5 hash of files that require it such as
.exe,.msi,.py, and other virus prone files.Speeds up zipping process by not compressing. Gives over a 5x speed boost.
Search API
The search API got a huge upgrade and has lots of breaking changes!
The search API now uses Orion in the background. Orion (or Orionoid) is a link provider which provides high quality magnet links, .torrent file downloads, and .nzb file downloads, with over 109 Million links in their database to search from all part of your paid TorBox plan!
This means much faster search speeds, much higher quality results, and better sorting.
BREAKING CHANGE: Meta search changed endpoint locations to
/meta/search, following the structure of the following new endpoints.Usenet search allows you to search by query at
/usenet/search. Output is exactly the same as searching by ID but uses a simple query instead for full text search. API DOCS.Torrent search allows you to search by query at
/torrents/search. Output is exactly the same as searching by ID but uses a simple query instead for full text search. API DOCS.You can now pass
check_cache, which allows you to easily check if any items in your search are cached by TorBox and instantly ready to download. This is available on all endpoints except the/metaroutes. API DOCS.You can now pass
check_owned, which allows you to easily check if any items in your search are already in the user’s TorBox account. This is useful so you can possibly remove these items or label them for users so they don’t add duplicates. API DOCS.BREAKING CHANGE: All searches other than the
/metanow require authentication with a paid account.
API
BREAKING CHANGE: Removes
/torrents/searchfrom the main API. This is due to wanting to consolidate all searching to a single API.Allows requesting to download a download as a .torrent file. Simply passing the
torrent_fileparameter will download the requested file as a .torrent file, for use anywhere. API DOCS.Using the
allparameter when controlling downloads (deleting, re announcing, etc) will queue the operation, due to the amount of time required to process all of a user’s downloads. Affects all/controlXXXXendpoints.You can now directly queue torrents without going through checks. This is useful if you just want to queue up a few torrents over a few requests. You can send the
as_queuedparameter to/torrents/createtorrentand it will be added as queued. API DOCS.
Website
Adds link back to Login page on Forgot Password page.
Allows sorting on the dashboard! The following are options and what they do:
Default is the default option. It shows newest at the top, with inactive and cached at the bottom.
Newest puts the newest items (created time) at the top.
Oldest does the opposite, putting oldest items (created time) at the top.
Last Updated puts the most recently updated at the top. This is good for watching active downloads.
A to Z sorts from A to Z, pretty simple.
Z to A sorts opposite of the above.
Allows filtering on the dashboard. You can filter by preset filters or by searching for a name or a file name, which was a highly requested feature. It also resolves this issue.
Can filter by Usenet Downloads, Web Downloads, Torrents, Cached, Inactive, Download Ready, Active, Downloading, and Uploading.
Searching is a fuzzy search, and likely still needs some tuning, so if you run into any issues, especially with Kanji or Chinese characters, please let us know!
Searching should be performant enough, but if you run into any issues, such as with a large list with a lot of files, please let us know.
Sort and filter added to the settings so that you can set your account to have a default, if you don’t like the current defaults. Changing from the dashboard won’t override your settings in the settings page.
Better error messages when adding torrents, Usenet and web downloads. Previously the generic errors were confusing users.
Various style changes to front page.
Redesigned Avatar panel.
Redesigned More Info panel.
Changes arrow for CTA enabled site-wide announcements.
Stremio Addon
Fixed “Your Media” showing non-video files.
Service
TorBox no longer selects cached torrents from other user’s accounts. If the torrent is actually cached, then it won’t use a slot. Previously even if the torrent was cached, it used a slot on every account that added the torrent. Now, cached torrents won’t use a slot, regardless. Resolves this issue.
TorBox now checks for file size on
.torrentfiles, prior to adding to the client. Previously this would cause issues with users downloading too large of torrents from private trackers costing a lot of download quota, and counting as a leech.This won’t be done for magnet links due to the time it takes to figure out the real size of the torrent before adding to a client, since it requires contact with the network.
Upgraded all servers to qBittorrent v5.0.0. We required API’s from their most recent update which was not available on older versions (previously v4.6.1). This should also bring more benefits such as security, and speed.
General service stability fixes.
API
Adds
offsetandlimitparameters to all/mylistroutes. This means that pagination is possible for users with over 1000 (the default limit) downloads to get all of their downloads in a few requests rather than not at all. API DOCS.Fixes cached
/torrents/torrentinfodata showing entire request response.
Service
Account statistics properly update hourly.
TorBox now scans for viruses on commonly infected file types. Read here for more information.
Website
If there is an infected file in your download, then the zip button and batch file copier is removed. The file is also not available to download and shows a helpful message about the file.
Removes Long Term Storage addon from avatar section.
Adds setting for sort in Stremio addon. Options are:
Seeders/Age, sorts by most seeds or youngest (if Usenet). This is the default option.
Size, sorts by largest first.
Resolution, sorts by best resolution first.
Removes mobile notifications settings, and mobile app buttons from website.
Removes TorBox mobile app from integrations.
Stremio Addon
You can now set custom sorting settings for the addon. You can now sort by highest seeders (which is the default), size, and resolution. This was a highly requested feature.
Cached items (Instant) are always sorted by resolution, showing the highest at the top, regardless of sorting. Sorting basically only affects uncached items.
Mobile App
Removed mobile app from Google Play for the time being. It was out of date, had many bugs, and nearly nobody used the app (Only had about 1,300 installs). This was an executive decision due to time spent developing mobile apps being very high. We want to spend more time on real features that everyone will use, rather than only a very small portion of our users.
Website
Fixes look of subscription page on mobile devices.
Fixes look of login page when keyboard is active on mobile devices.
Fixes centering of buttons on login page on mobile devices.
Adds details to Usenet downloads when they go inactive.
Removes pause and resume buttons from Usenet and torrent downloads on the dashboard.
Fixes deleting queued downloads from the dashboard.
Made notification, profile, and additional items popup tabs match the width of the entire set of buttons making it look much better.
Removes ability to purchase long term storage addon.
Service
Removes the long term storage addon. This was a voted decision due to costs and abuse of the addon. We never intended for the addon to be used for hoarding, which is what it introduced, which TorBox is not in a position to allow right now. This addon will be revisited in the future as it was very popular.
API
Removes the ability to pause Usenet and torrents. This was causing issues, and it was never used much anyways.
Website
Fixes JDownloader2 Integration on download page.
Adds guide for FTP on the settings page.
Adds Copy Manifest URL for Stremio addon.
Adds guide for Stremio addon on the settings page.
Adds more info to settings items.
Removed “BETA” tag from FTP!
Stremio Addon
Makes streams easier to preview on mobile devices.
Better description views.
Descriptions no longer contain resolution as it was redundant.
Order now goes, Quality, Name, Size, Language, Type and Seeders (and Age respectively).
Fixes rate limiting issues in rare cases.
Fixes Your Media titles showing up incorrectly.
Service
Better detection of temporary emails.
Tinfoil
Fixes downloading from Tinfoil server.
Website
Allows linking directly to addons, and one-time purchasing tabs.
Dashboard has new button in yellow showing addons labeled “Explore Addons”.
Properly fixes notification messages which overflow onto the page.
Changes dates on dashboard and settings to absolute dates from relative dates for user ease of use.
New action button on Dashboard with buttons with links to frequently wanted things. This will get more work soon, maybe something like a search will go here instead.
All action buttons on the Dashboard now have tooltips when you hover over them. Some users were confused at times about the buttons.
Service
Fixes Usenet and Web Downloads expiring prematurely if the user has the long term storage addon.
FTP
Fixes folders showing as files.
Fixes missing files inside of folders.
Fixes some files showing as folders due to extension not being supported. Extensions such as
.opus,.srt,.ttfwere showing as folders. If you find any extensions not supported (supposed to show as files, but show as folders), please report them to us!
API
General bug fixes.
Properly updates the
updated_atkey on files when being removed from cache.
Service
Rewrite of our web download system! Previously web downloads were inefficient, slow, and unreliable. Most pressing issues have now been solved.
Adds support for Mega folders.
Downloads YouTube videos properly.
Adds support for YouTube playlists.
Adds support for Yandex Disk.
Adds support for Archive.org.
Better support for direct downloads.
Faster downloads!
and more!
Fixes some torrents not showing full size of the torrent on the dashboard.
More accurate download statistics.
Better support for NZB names. This should further reduce the chances of getting “Unknown NZB Name”
Our TorBot AI for customer support now has knowledge about the API, so if you have an API question, feel free to ask support! The AI will attempt to answer your question as best as possible.
Removed transcoding video for playback on the browser. This wasn’t a very popular feature, and it ended up just causing more issues. The streaming page will now retrieve captions, as well as the video file for streaming.
It is important to note that not all files will be able to played anymore. For example,
.mkvfiles will no longer work in the browser. We recommend downloading these videos and using them on your device locally.
Downloading zips should be more reliable as well as include file size. Speeds should be similar. Please report if you notice speeds to be slower than usual.
Fixes users getting signed out of the TorBox website when logging into the WebDAV or FTP servers.
Website
Adds guide for JDownloader2 Plugin integration.
Adds guide for Ferrite integration.
Adds Cyberduck integration to integrations page (includes a guide).
Adds Filezilla integration to integrations page (includes a guide).
Sorts integrations in alphabetical order.
API
Adds ability to specify an ID when requesting from
/mylistendpoints. Simply send anidparameter with any/mylistendpoint, and it will return data only about thatid(if it exists). API DOCS.Adds ability to define a password to be sent when creating a Usenet download. You can now send password as part of the form to the
/createusenetdownload, and it will use that password to extract the RAR at the end of the download. API DOCS.Adds ability to define a post processing option to be send when creating a Usenet download. This will define what the Usenet client does with the files after it is completed downloading. It is important to note that TorBox will still perform its own processing. API DOCS.
Downloading zips now comes from https://storage-zip.torbox.app rather than https://storage.torbox.app. Paths and methods are still the same.
Tinfoil Server
Fixes downloading.
Makes more secure by internally requiring API key for every download.
Website
Allows sharing cached torrents. Adds button in menu, as well as context menu. This also fixes it to work with all torrents, not just torrents created with magnet links.
Allows copying the magnet of all torrents. This can be found by right clicking, or tapping and holding to bring up the context menu, and under the “Extra tools” sub-menu.
Fixes downloads on dashboard not being added or deleted properly. You would previously have to refresh the page for a deleted download to actually disappear.
Allows exporting all torrents as .torrent. Previously only active torrents were able to do this.
Service
Fixes some Usenet and web downloads showing permanent download speed, even after completion.
Now uses uploaded .nzb filenames to give a filename hint, to prevent Unknown NZB Name irregularity.
Fixes streaming from the TorBox website. Still has small instabilities, but we are working on it.
Fixes integration downloads (upload to Google Drive, upload to 1Fichier, etc).
Website
Fixes linking and unlinking Discord accounts.
Adds context menu to Usenet downloads (right click menu).
Adds context menu to Web downloads (right click menu).
Fixes some UI issues in the settings page.
Service
New 80gbit NVME servers! This comes with obvious speed benefits, but also stability and reliability benefits too! Enjoy!
Service
Email is now sent when account is deleted.
Email address is now properly shown in notification emails.
Updated privacy policy.
Website
Made Cloudflare Turnstile widget same size as login inputs and buttons for visual clarity.
Increases delete account button press length to 5 seconds.
Adds stats page! View some cool statistics about TorBox and what it’s doing day to day with some awesome graphs! You can view the below graph types:
Total Downloads - Number of downloads over the last 30 days. This includes torrents, Usenet and web downloads.
Total Users - Number of users over the last 30 days.
Total Satellites - Number of available downloading servers over the last 30 days
Total Downloaded Bandwidth - Total amount of ingress bandwidth over the last 30 days. Includes torrents, Usenet and web downloads.
Total Seeded Bandwidth - Total amount of egress bandwidth spent on seeding torrents, whether public or private.
Total Egress Bandwidth - Total amount of egress bandwidth spent on serving files to users, whether streamed or download. Does not include bandwidth spent from WebDAV or FTP.
Adds Referral Link copy button to profile menu. This was done for easier finding of it, since a lot of our users didn’t know where to find it.
Adds referral section to settings page. Same with the reasoning to add it to the profile menu, since it was hard to find.
Adds button to copy code.
Adds button to copy link.
Adds API key to localStorage, for making use with future webapps and extensions.
API
New statistic, Total Egress Bandwidth. Like said above, it is the total amount of egress bandwidth spent on serving files to users.
Allows running operations on all torrents, queued torrents, web downloads, and Usenet downloads. You can now send the
all=trueparameter, without requiring a single id. This is useful for batch operations.
WebDAV
Updated styling of WebDAV UI.
Speed Test
Updated styling of Speed Test UI.
Website
Adds delete account button to website, this was highly requested. Requires you to hold down on the button for at least 1 second to delete.
Adds live service status to the footer of every page (with a footer). This is useful for checking at a glance if something is wrong or not.
Switches from Chatwoot support to Intercom support. This comes with a lot of perks, mostly for us at TorBox, but also for the users as this will now include AI answers that can possibly answer your questions faster than a support agent could.
A new and beautiful help center with better accessibility and ease of use. You are now properly able to search for answers to common issues. The AI is also trained using these articles, so ask the AI questions!
Changes help center links to new help center on Intercom.
Service
Reduced prices of active slots addons by around half! This means for those of you interested in seeding a lot, or mass downloading, it is much more accessible!
5 Additional Slots reduced from $3 → $2
10 Additional Slots reduced from $6 → $3
25 Additional Slots reduced from $15 → $8
Remember, these stack meaning you can subscribe to multiple and they will add up properly.
Better detection of NZB names. This reduces your chances of getting an annoying Unknown NZB name. When using links, such as from search, it will use headers from the download of the link to get an NZB name. Usually the names of downloads are in the headers of the links, so we are now using those to piece together information.
Better size detection of completed usenet downloads. Before, a lot of downloads would show 0B for no size. This will get the most accurate sizing.
Better size detection of completed web downloads. Same with Usenet, a lot of downloads would show 1B or 0B for no size. TorBox will now show the accurate size of the download after processing.
Website
Avatar section now shows your max allowed concurrent active slots.
Avatar section now shows your enabled addons, such as the Long Term Seeding addon, as well as the Long Term Storage addon.
Fixes drop down icon which appears on smaller screens to use new icon format. Also fixes the weird spacing in between the drop down button and the torrent button.
Stremio Addon
The Stremio addon now shows web downloads inside of “Your Media”. If you downloads some media using the TorBox web downloader, it will now show up in Stremio.
The Stremio addon now searches for web downloads when clicking on streams. If you have any web downloads in your account, which match the title of the media you are trying to find a stream for, it will now use web downloads along with torrents and usenet downloads.
Website
Settings inputs are properly de-bounced so you don’t get a notification on every single modification.
Removed mentions of VPN and removed tool to download the VPN.
Service
Disabled registering for VPN. Cloudflare Warp has removed referral access so no new accounts can be created using it.
Emails are even more beautiful now!
We had to deal with a lot of challenges such as supporting different email clients, looking good over standard HTML, plaintext and every other way email can be displayed, as well as the standardization (or lack thereof) of email clients not supporting special fonts, etc. Most elements on the email are actually just rendered images to get the look we wanted.
API
Fixes issues with eTags. We simply removed them, as well as last modified headers.
Allows getting queued downloads, and information about them. API DOCS.
Website
Removed magic links. They were an anti user experience feature, and caused more trouble than they were worth. All new sign ups will be done with standard email and password. Most users also set a password right after signing up, so this reduces time spent setting up your account.
Invalid and disposable emails are now rejected in a more reasonable way. While signing up, you will get a notification if the email is invalid or disposable. New requirements are as follows:
Must have valid MX records for receiving mail.
Must be a valid domain.
Must not currently be in use by another user (this also includes duplicate emails employing the “+” and “.” trick).
Passwords are now required to be very strong, right from the start. This will improve site security and reduce risk for TorBox. Requirements are as follows:
One lower case letter.
One upper case letter.
One number.
One special character.
Not part of any haveibeenpwned databases.
Not a common password.
Errors are now properly given and sign ups are a lot easier to go through.
Magnet links have better regex and form validation.
Copy batch links and zip download icons have brand green loading icons rather than white.
Service
Redesigned emails. They are a lot better looking and will still receive improvements over time, as we have developed our own email UI and framework for easily creating and modifying emails.
Logging in now requires the API, so if the API is slow or down, then logging in won’t be possible.
NOTE: If you previously used magic email to sign in and never set a password, you must get a reset password email, by going to https://torbox.app/forgotpw.
\",\n \"markdown\": \"### **Website**\\n- Removed magic links. They were an anti user experience feature, and caused more trouble than they were worth. All new sign ups will be done with standard email and password. Most users also set a password right after signing up, so this reduces time spent setting up your account.\\n- Invalid and disposable emails are now rejected in a more reasonable way. While signing up, you will get a notification if the email is invalid or disposable. New requirements are as follows:\\n - Must have valid MX records for receiving mail.\\n - Must be a valid domain.\\n - Must not currently be in use by another user (this also includes duplicate emails employing the “+” and “.” trick).\\n \\n- Passwords are now required to be very strong, right from the start. This will improve site security and reduce risk for TorBox. Requirements are as follows:\\n - One lower case letter.\\n - One upper case letter.\\n - One number.\\n - One special character.\\n - Not part of any [haveibeenpwned](https://haveibeenpwned.com/Passwords) databases.\\n - Not a common password.\\n \\n- Errors are now properly given and sign ups are a lot easier to go through.\\n- Magnet links have better regex and form validation.\\n- Copy batch links and zip download icons have brand green loading icons rather than white.\\n\\n### **Service**\\n- Redesigned emails. They are a lot better looking and will still receive improvements over time, as we have developed our own email UI and framework for easily creating and modifying emails.\\n- Logging in now requires the API, so if the API is slow or down, then logging in won’t be possible.\\n\\n***NOTE: If you previously used magic email to sign in and never set a password, you must get a reset password email, by going to ***[***https://torbox.app/forgotpw***](https://torbox.app/forgotpw)***.***\\n\",\n \"link\": \"https://feedback.torbox.app/changelog/v462\",\n \"created_at\": \"2024-08-13T20:35:27Z\",\n \"id\": \"66bbbfdaa4fc8bb23e342930\"\n },\n {\n \"name\": \"v4.6.1\",\n \"html\": \"API
Fixes “controlusenetdownload” route name. Previously it had a typo in it.
Fixes deleting failed Usenet downloads.
New route
/torrents/torrentinfoallows you to send a hash of any type and get all BitTorrent metadata info about it. This retrieves data from the BitTorrent network and is not reliant on if TorBox has it cached. API DOCS.
Service
Allows using RSS feeds that have magnets, previously only torrent file RSS feeds were allowed.
Website
Fixes dotted font in some places where it looked a little strange.
Adds new loading animation! It matches TorBox better.
Discord Bot
Updated help menu to have all of the new available commands.
Website
The website got a makeover! Say hello to our new icons and font! The icons are all custom and handmade to fit TorBox perfectly, and the font is uniquely special to TorBox as well as the matching “Dotted Icons” (we don’t really know what to call them).
If we had the time, we would tell you all about our design choices, all the different icons, etc, but you will have to discover all of them yourself!
![](\\\"https://fb-usercontent.fra1.cdn.digitaloceanspaces.com/01911134-a2e7-7363-bedc-193c5ee09f78.png\\\")
On the dashboard, all downloads are given a tag which tells you exactly what they are, whether torrents, web downloads, or usenet downloads, there is no more guessing which is which!
Better sorting of downloads on the dashboard. We got a lot of feedback that new downloads were hard to find, or that they had to scroll halfway through the page, just to view the download. Currently we are sorting by newest, as well as giving some weight to active downloads being at the top, and inactive at the bottom. Soon this will be customizable as well as filterable!
Fixed notification message copying the title instead of the message.
Service
Queued torrents are now checked after the manual “Stop Seeding” control action is called. Previously, only deleted torrents did this.
The service and APIs should be much more stable. We have changed our infrastructure once again, and we are hoping this provider will be able to meet our needs. We are very confident!
Updated Infrastructure Status page to show newest servers.
DOWNLOAD001, DOWNLOAD002, and DOWNLOAD004 were put out of commission due to slow networking performance by the provider. DOWNLOAD003 was kept due to the good deal. 😁
FTP
Fixes compatibility with RClone.
There is a known issue with Infuse not working with FTP. It will constantly load, and no video will play. We recommend using the TorBox WebDAV instead.
Stremio Addon
Fixes duplicated downloads being added on uncached streams.
Listing speed increases due to more optimized code.
Fixed bug where on first search, there would be little to no results, but when you came back, there would be more. First search now provides the same amount of results.
Fixed size and seeders have no value.
Removed peers from description. Didn’t really matter.
Searches have way more results!
Streams now have much more accurate data. This includes language, resolution and quality. This is due to our fork of TheBeastLT’s Parser (known and used for Torrentio Stremio Addon). We were previously using their parser for our own addon.
We were unhappy with the results, so thanks to help from PTT by Dreulavelle, we have amazingly accurate data in the Stremio addon now!
I guess you can say that we are now better than Torrentio (even though we already were).
You can view and even possibly contribute to the code here.
Service
Fixed service! Most downloads should be available to download. As of writing this changelog, we are still missing about 20TB of data, and about half of that is already located on the servers, we just have to
mv /old /new, which unfortunately has to be done last, after the final 10 or so TB have been transferred from the old servers. All new downloads, anything seeding, and most cached downloads will be working. Over the next few weeks we are bringing all data back.Our server are now all 10Gbit and downtime resilient!
Download at nearly 10Gbit speeds as much as you want.
If one of our servers goes down, it only affects the files on that server, not the entire service. Before if any server went down, it would cause everything to fail, which is definitely not acceptable, when your fleet is 10+ servers large.
Reliability patches and lots of bug fixes throughout. We can’t even list them all, or else no one would want to read the change log.
Website
Adds Discord Bot to integrations page.
Adds new Telegram Bot to integrations page.
Adds new Comet integration to integrations page.
Adds ElfHosted to integrations page.
Adds Mega integration to integrations page.
Adds guides for West’s Blackhole script, Riven, Mediafusion, and Comet.
Adds the ability to enable or disable Telegram notifications from the new Discord bot.
You must have your Telegram account linked for notifications to be delivered to you.
Adds the ability to link your Telegram account to TorBox to be able to receive notifications.
Changed username and password of Tinfoil server to use API key.
Fixes errors for integration uploads. Rather than giving you a generic error, it is detailed from the API, telling you exactly what went wrong, and a possible remedy.
Enables ability to transfer files to your Mega account! Before the button was just lurking there, ready to be used, and now it finally can be! Simply make sure you have your Mega credentials set in the TorBox settings and click the button!
Mega uploads won’t show progress, just like 1Fichier and GoFile due to the way files are uploaded.
Currently zips aren’t possible, due to the way they are uploaded, but there is a “beta” in the API if you still want to try it out.
Allows you to add your Mega account to TorBox in the settings! Simply enter your credentials and click “Login to Mega” to save them. They will be encrypted and the next time your refresh the page, they will show encrypted.
There is a button that allows you to delete your credentials when you have saved them previously.
Like stated above, credentials are encrypted in AES-256, they don’t even hit our database until they are encrypted, so you can be sure that even if something drastic happened to our database, you Mega account will be safe.
Obviously both username, and password are required to use Mega.
Tinfoil Server
Tinfoil server now uses your API key for authentication. This is due to Tinfoil not correctly encoding data before it is sent leading to authentication issues.
Username will always be
torboxPassword is now your API key.
This also prevents password sharing as your API key is core to everything on TorBox, you can modify basically everything about an account using an API key, which should prevent mass sharing.
Serving files should be more reliable. Before, we would base64 encode the path of the file, which would lead to buffering issues and encoding issues depending on the name of the file (Japanese characters would cause issues), so now we simply use ID’s for everything leading to near perfect reliability.
Indexes are now encrypted. This prevents people from seeing the download links and potentially sharing them.
Telegram Bot
Introduces the TorBox Telegram Bot! A lot of people have been asking for this for awhile and it has been on the to do list for just as long, so we decided to give it a shot.
The bot was built using https://grammy.dev/ meaning the process was insanely simple, and most of the code was taken from the Discord bot.
You are able to do all the same functions as in the Discord bot, just in Telegram, the privacy conscious chat platform.
The bot is very clean and simple to use, with simple commands, and a simple to use interface.
You can also receive notifications through the bot. The bot will simply send you a message whenever you get a notification, and it can act as a push notification to your mobile device if you don’t want Discord notifications.
API
Adds plans number key to API docs. API DOCS.
Fixes cache check returning null if the hashes sent are not all lowercase. This allows for mixed type hashes to be sent now.
This is a bit of a smaller update, but one that rounds most of the jagged edges TorBox has had for awhile, as well as introduces some pretty cool things. We would also like to apologize to everyone for the server issues we have been having recently, we desperately are trying to claw our way out of it, and right now, it is just a waiting game, as hardware is arriving. We hope to make it up to all of you, and maybe bring some of those who have unsubscribed from the service due to the issues (we miss you!). Anyways, please enjoy this update. We will create a new change log and site announcement when things are back up and running at 100%. We promise the wait will be worth it.
Service
Adds the ability to download your files from Tinfoil! No more need for scammy shops, NUT, or clunky transfers! Simply input the TorBox Tinfoil Server connection details into your Tinfoil app and start directly installing to your Nintendo Switch.
Please note that we don't provide games, or support piracy in any way. This is simply an easy way to transfer your owned files to your Nintendo Switch.
To connect, simply make sure you have
.nsp,.nsz,.xcior.xczfiles inside of your TorBox and open Tinfoil on your switch and use the connection details below:Protocol: https
Host: tinfoil.torbox.app
Username: Your TorBox email. Make sure to replace the '@' symbol with '%40' as Tinfoil doesn't officially support emails when connecting.
Password: Your TorBox password.
Name: TorBox
You were previously able to use Tinfoil through the TorBox FTP, but this is simply another way to interact with your TorBox files from Tinfoil (as well as being easier).
You were also previously able to use Tinfoil with TorBox through Google Drive, but as it’s not automated, it makes it difficult, as well as the setup being generally difficult and somewhat time consuming. This is just a better way in almost every way.
Adds the ability for TorBox to send notifications over a webhook! This allows you to do a whole lot of interesting things with your notifications as soon as you receive them!
Discord and Slack are natively supported, simply add a webhook from either site and TorBox will recognize it and send you a fancy notification on the respective platform!
If not a known service, TorBox will simply send the following payload which is standard according to Standard Webhooks:
{\\n \\\"event\\\": \\\"torbox.notification\\\",\\n \\\"timestamp\\\": utc_iso_time,\\n \\\"data\\\": {\\n \\\"title\\\": \\\"string\\\",\\n \\\"message\\\": \\\"string\\\"\\n }\\n}
Fixes Google Drive uploads and logins. Previously they would fail at 100% due to recent issues with our IP’s being incorrectly flagged on Spamhaus due to rack neighbors. This issue has been solved for the most part, but it is likely still going to be an ongoing fight.
Website
Adds Tinfoil as integration to the integrations page.
Adds Wireguard as integration to the integrations page.
Adds SABnzbd as integration to the integrations page as it works with the TorBox Usenet provider.
Adds RClone FTP as integration to the integrations page.
Adds Tinfoil Server to settings page, which shows all of the info necessary to connect to it.
Adds Usenet Provider to settings page, which takes you to the tools page to actually get your credentials.
Adds ability to change whether you want to receive notifications inside of the JDownloader application (not yet implemented into the plugin).
Adds ability to view the tracker message, if any, when switching on viewing the tracker.
Hides tracker sensitive information on dashboard, simply shows the host name of the tracker on the dashboard.
Adds ability to stop seeding a torrent. This is good for when you feel as though you have seeded enough, or simply want to recover a slot while still keeping the torrent.
Adds Webhook Notification setting to the settings page to determine if you want notifications sent to the given webhook url.
Adds Webhook URL setting to the settings page, where notifications will be sent if enabled.
Adds a test notification settings button. This will simply create a notification in the standard way, to test your notification setup. It will only send a test notification to your enabled notification options. Useful if using webhook notifications and you want to make sure they work. This will not create test notifications for web notifications or RSS feed notifications (if enabled).
Tinfoil Server
The Tinfoil server is introduced to TorBox services. This allows you to download your files directly from TorBox to your Tinfoil application.
We have created an open source and self-hosted version of this API, which you can run for yourself, on your own computer or server. This releases the pressure from us to host this API for public consumption, so if we ever take down the Tinfoil server, you are able to host and run it yourself, and it will work exactly the same as the hosted version!
Discord Bot
Fixed reliability and made more robust.
API
Allows providing a name to the
/torrents/createtorrent,/usenet/createusenetdownload, and/webdl/createwebdownloadendpoints. This allows you to provide a custom name with your downloads, so it can be named as you like. This fixes issues with torrents having unknown names. This is currently not implemented on the website or in the Stremio addon. API DOCS.Adds the ability to send test notifications. This can be found at
/notifications/test. API DOCS.
Website
Fixes a bug where the dashboard would never load on Android Microsoft Edge browser sessions. This was due to our notifications API we were using, and have since switched to the browser native Notifications API.
The Tools page has a new tool! You can now get your Usenet credentials for the TorBox provider (more below). This is simply an easy way to view your credentials and even reset them if needed.
Service
Switches back from our 10gbit servers. They weren't ready for production, even after testing, and their performance wasn't enough regarding uploads to the servers. This lead to completed downloads erroring out due to the files not being uploaded fast enough. We have since moved back to our old servers and are working on higher performance servers.
TorBox now offers the ability to use TorBox as a provider for downloading from the Usenet on your own server! For Pro users, you are able to generate an account to use on your favorite Usenet provider.
TorBox offers 25 connections, SSL, and speeds up to 20gbit on almost all the major backbones.
Host: usenet.torbox.app
Port: 563.
This feature is in beta, and not meant to be your main provider at this time. We are working on making this better, so it could possibly replace your Usenet providers!
FTP
Fixes going more than 2 folders deep. Before, it would show nothing, but now it works as expected.
Allows use of FTPES for clients that don't accept the SSL certificate.
Fixes issues with Infuse not showing downloads.
Service
All of TorBox servers are now 10gbit! This means that in general, downloads from TorBox to your devices should be much faster in general. In our testing average download speed has doubled. Below is a screenshot of a transfer we got using a max connection limit of 16. Pretty quick!
![](\\\"https://fb-usercontent.fra1.cdn.digitaloceanspaces.com/1719823875351..jpg\\\")
All of TorBox storage servers are now fully encrypted. This means that the files on our servers are encrypted and combined with fully encrypted transfers over https, and SSL, you can be sure that no one will ever no what you are downloading.
API
All API responses now include an \\\"error\\\" key. This allows developers to get a better understanding of an error and handle it better. API DOCS.
Service
Adds FTP(s) service. You can now connect to the TorBox FTP servers at ftp.torbox.app from port 21!
FTP
Introduces FTP(s) service in beta, meaning there may still be bugs and issues.
Load balanced and protected with TLS and SSL certificates! Keep your connection secure by making sure you settings use TLS. You may also choose to use unprotected FTP.
Perks of the FTP is that it is faster than WebDAV, especially for listing files and folders.
Compatible with RClone.
Able to use from any device, anywhere that FTP is available, even from other seedboxes!
Allows use with any FTP client.
KNOWN ISSUES
Some folders that end in an extension, such as mkv, mp4, txt and others will be recognized as files rather than folders and will not be able to be downloaded.
Going into folders can sometimes lead to no results. Simply give it a refresh and it should give you results. If it doesn't, don't worry, we are aware of the issue and are working on it.
Stremio Addon
Improves scraping and torrent name matching (should give more results than previously.
Fixes a few bugs that lead to no results being shown.
Search API
Fixed 418 errors. Issues with proxies.
Discord Bot
Ability to add web downloads and usenet downloads.
The command to add a web download is
add-webdownload.The command to add a usenet download is
add-nzb.You are allowed to send in either an nzb file or an nzb link.
The command name for adding torrents has been changed to
add-torrent.Ability to list web downloads and usenet downloads.
The listing command got a big upgrade too!
Can list all downloads, only torrents, only usenet download or only web downloads.
The list has been compressed into one embed, and you are able to scroll through the list using pagination.
![](\\\"https://fb-usercontent.fra1.cdn.digitaloceanspaces.com/1719274754993..png\\\")
WebDAV
Speeds have increased again. Previously it was at about 7 seconds average, now it is at about 3 seconds average. This was due to preventing a lot of unnecessary calls to the database, and keeping pretty much all data in redis.
This is a pretty large update with a lot of quality of life changes, as well as some missing additions to already existing features. The biggest things to mention are all the new integrations that TorBox now has. You are now able to upload your files directly to Google Drive, Onedrive, Dropbox, 1Fichier, GoFile, and soon Mega. You are now also able to add links directly to JDownloader2. Along with uploading and downloading files, we now have a JDownloader2 plugin! Thank you to the JDownloader2 team for creating this! There are a ton of other new integrations that we will go over below. This is also a \\\"Fix everything\\\" version. We fixed so many glaring issues with the service, which we are very happy about.
Website
Fixes \\\"Open in Player\\\" button to show the drop down properly on all devices.
Fixes \\\"Open in Stremio\\\" button not working properly.
Changes \\\"Open in Download Manager\\\" button to \\\"Copy Link\\\" button.
Fixes links properly copying on Firefox and Safari browsers.
Changes look and feel of notification popups. They now group up and show on top of each other. This change saved us over 1000 lines of code in total, across the entire website, and it is a lot simpler for us to now make changes to the look and feel of notification popups. More work will be done on these in the future.
Allows you to pass a password to the debrid. You can now download files with passwords from hosters. Of course, this is optional for files not requiring a password.
Fixes quick add page not adding torrents.
Changes look of download buttons on the download page. Shows status of transfers on the button depending on the download.
![](\\\"https://fb-usercontent.fra1.cdn.digitaloceanspaces.com/1718568130225..png\\\")
Allows you to download a file directly to JDownloader. On the download page, simply click the \\\"Add to JDownloader\\\" button, and it will open JDownloader2 (assuming the application is already open on your computer) and will prompt you asking if you want to add the link. This button saves you a step, rather than clicking on Copy Link, opening the app, and going through all the steps, this is a simple button.
Google Drive, Onedrive, and Dropbox integrations are a lot more simplified.
For Google Drive, it will work mostly the same, simply click \\\"Add to Google Drive\\\" and it will open a popup (or new window/tab) asking you to choose an account, and give permissions to TorBox to access your Drive. It will then begin uploading to Google Drive.
For Onedrive, the process has been simplified greatly. Before, you had to (for some reason) click and log in multiple times. This time around, it's a single login, like it should have been.
For Dropbox, this is the biggest change, login is simplified, like all the others. You no longer can select a folder like before, it simply uploads everything to it's own \\\"TorBox.app\\\" folder. While some might not appreciate this, it allows all files to be organized where they came from. The other big change is that it no longer requires you to upload the file using your own internet. Before, your internet acted as a proxy that downloaded from TorBox, and uploaded to Dropbox. This was slow, and prevented you from leaving the page, unless you no longer wanted your download. Now, just like all the integrations, uses TorBox's own high speed servers to upload directly to Dropbox's servers.
Added 1Fichier integration. Allows you to directly upload your files to 1Fichier and get a link that takes you directly to the 1Fichier download page. With this you can also define a folder along with a login token in the TorBox settings, that allows you to put your files wherever you want in your 1Fichier account. You can also define a password when uploading to 1Fichier (This is only available via API at this time).
Added GoFile integration. Allows you to directly upload your files to GoFile and get a link that takes you directly to the GoFile download page. You can also define your API key and a folder in the TorBox settings so you can put your files wherever you want.
The new integrations page shows off all of TorBox's amazing integrations in an easy to digest way, allowing you to view the pages, and authors, as well as a basic description of the integration and what you might use it for.
![](\\\"https://fb-usercontent.fra1.cdn.digitaloceanspaces.com/1718567924927..png\\\")
Adds section to landing page about integrations with a button taking you to the integrations page, we are pretty happy with how this turned out.
![](\\\"https://fb-usercontent.fra1.cdn.digitaloceanspaces.com/1718568009521..png\\\")
Fixed a small edge case where the allow zip switch wouldn't be switched the same as the settings if opening and closing the Add Torrent popup.
Service
Fixed some RSS feeds not working properly due to links not being accessible, due to redirects or others. The API will now follow redirects to be able to cater to more types of RSS feeds, rather than standard ones.
Fixed previously missed RSS feed items from never downloading. The API will now check all of your previously, not downloaded, and not ignored RSS items for new torrents.
Background tasks now run properly. These are invisible tasks that are crucial to the service staying afloat, and previously they were crashing, getting cancelled for some random reason, or other things that were preventing them from running.
Payments
We finally made the move to Sellix subscriptions. All Stripe subscriptions were cancelled and users were advised to switch to our new subscription system, as to not lose service.
Integrations
Riven, a Plex-Debrid rewrite has added TorBox as a debrid! This allows you to use TorBox with Plex simply and easily using a simple app, either self-hosted, or hosted using an external service such as ElfHosted. We will be writing a guide on how to integrate and setup Riven with TorBox soon.
Ferrite, a media search engine, which allows you to add searched items to a debrid, has added TorBox as a debrid! This allows you to use a Stremio alternative, on iOS devices. We will be writing a guide on how to install and use Ferrite with TorBox soon.
JDownloader2, one of the most popular download managers has created a TorBox plugin, that allows you to use pretty much all of TorBox's features, right from the JDownloader application! You don't even need to use the TorBox website if you wanted to. We will be writing a guide on how to install and use it with TorBox. THIS IS CURRENTLY IN BETA. If you encounter bugs, please report it to us or the JDownloader team.
Using TorBox with the *arr apps is now possible! Thanks to this application created by West, you can now use TorBox with your already existing arr apps! It is a little complicated to get set up, but we will be writing a guide on how to install and use it with TorBox.
Like mentioned above, we now have 1Fichier and GoFile integrations, which work seamlessly with TorBox. We are also working on a Mega integration as well.
Stremio Addon
The TorBox stremio addon now gets searches from Torrentio and other existing search APIs, as well as it's own. This is due to the amount of complaints we get about quality as well as loading speed with our own search API. While we are very proud of our own APIs, it is very obvious that we haven't spent as much time perfecting the search as Torrentio or other search APIs have. We want to provide the best experience possible for our users, so even if that means not using our own home grown solutions, we will do it, so we have. Results should be nearly identical to Torrentio, but will all the added features of TorBox's Stremio addon.
Fixed filtering and gave more results to addon due to bad parsing.
Discord Bot
Fixed handling torrents that don't have a name attached. Before, the application would crash trying to split up a torrent magnet. This is no longer an issue.
WebDAV
Slightly increased responsiveness and decreased response times (this is a good thing). Average response time dropped from 25 seconds (uncached) to about 12 seconds (uncached), and from 12 seconds (cached) to about 7 seconds (cached). We would call that a success! The change was that each file was being hashed (getting the MD5) every time the file was part of a request. This is exceptionally inefficient, luckily this has been fixed.
API
BREAKING CHANGE: There is no longer any endpoints for adding to Google Drive, and Onedrive from the
/torrents,/webdland/usenetendpoints.BREAKING CHANGE: For the
/checkcachedendpoint, if there are no cached results found, the data key will only show null rather than an object. API DOCS.NEW:
{\\n \\\"success\\\": true,\\n \\\"detail\\\": \\\"No cached data found.\\\",\\n \\\"data\\\": null\\n}OLD:
{\\n \\\"success\\\": true,\\n \\\"detail\\\": \\\"No cached data found.\\\",\\n \\\"data\\\": {\\n \\\"data\\\": false\\n }\\n}You are now able get the files inside of the cached torrent/web download/usenet download. This works on any of the
/checkcachedendpoints (as all do the exact same thing). This can be used for more rich data to show to your users. It shows the name of the file, as well as the size of the file in bytes. API DOCS.You are now able to pass in a password to web downloads. This allows you to unlock a file if necessary. API DOCS.
You can now request user settings when viewing user data at
/me. API DOCS.Web downloads now have an
errorkey, which is supposed to be viewed during or after a download has failed or is downloading. API DOCS.New
/integrationsmain route has all of the integration endpoints. This is where the Google Drive and OneDrive upload endpoint have been moved. It also adds all of the other integrations, OAuth, and Jobs. API DOCS.
Service
Makes the speed test page look like the rest of TorBox. Last time we did WebDAV, now we have gone ahead and done the speed test page to look all proper. An added feature of this change is seeing test files that are available to download to test real life speeds. A lot of users didn't exactly know this existed, so here it is.
![](\\\"https://fb-usercontent.fra1.cdn.digitaloceanspaces.com/1717493116079..png\\\")
Stremio Addon
Faster searching speeds. Speeds for uncached data should be about 33% faster.
Better search results. There should be more results, and more resolutions available. Before, seeing 2160p content was rare. With the new search API, it is quite common (if even available).
Search API
Internally, we have switched from Jackett to Prowlarr, which has already shown to give better searching speeds and gives better results.
The
ageparameter is now available on torrents as well. Shown in days.
API
All endpoint responses have been standardized now. Before it was only /torrents, now it should be every endpoint. Below is what the response looks like:
{\\n \\\"success\\\": Boolean,\\n \\\"detail\\\": String,\\n \\\"data\\\": Any\\n}
Service
Subscriptions are now handled solely by Sellix. Our future at Stripe is looking bleak and we decided to move sooner rather than later. We believe in the future of Sellix and their awesome developer team.
Allows you to create subscriptions using PayPal, Cashapp, Cryptos and more.
More privacy. Stripe allowed us to see a lot about the user purchasing, which we weren't exactly happy about. We hardly ever looked at customer data, but there are times when we must, and the amount we had on a user was sort of unsettling. Data such as Name, Region, IP, Card Details, and sometimes even address and zip were exposed to us by default with Stripe. Sellix keeps customer privacy first which are very happy about.
Localized payments and region specific pricing (coming soon). Sellix has more power over their systems than Stripe seems to have, and it allows you to view payments in your own language and currency and soon, region specific pricing.
Long term stability. Stripe has a rocky history of banning businesses and keeping funds. We would rather not let that happen to us.
Upgrades and downgrades are now prorated! If you upgrade your subscription your days will be prorated to your new plan.
Long term seeding is finally here! You can now seed your torrents for as long as you are subscribed to the plan! Your torrents will continually seed with unlimited ratio with no issue. This also is sort of like long term storage (read below). Seed all your private torrents or seed your favorite publics!
![](\\\"https://fb-usercontent.fra1.cdn.digitaloceanspaces.com/1717214858318..png\\\")
Long term storage is also here! You can now store your files for infinite amount of time through TorBox! For only $6/mo, your files no longer expire after 30 days of inactivity! This allows you to hoard to your heart's content. Fair use storage is currently set to 3TB before it sends us a notification, and we have to look at your account. If you need more storage than that, we can work something out for you at around $2/tb.
![](\\\"https://fb-usercontent.fra1.cdn.digitaloceanspaces.com/1717214458338..png\\\")
New status page! This allows us more control over monitoring our services in a UI that looks much better and gives users more information about issues going on at TorBox. This includes incident tracking and management, which we can use for a whole lot of things.
![](\\\"https://fb-usercontent.fra1.cdn.digitaloceanspaces.com/1717213413938..png\\\")
WebDAV
The WebDAV has a new, but still familiar look! This allows the WebDAV to match to the rest of the TorBox service design, something we are very proud of. This should also make your experience a little easier as well.
On top of that, you now get a download count, a file count, and a functional logout button!
![](\\\"https://fb-usercontent.fra1.cdn.digitaloceanspaces.com/1717213570473..png\\\")
Website
The subscription page has been updated to look like all the other pricing sections. With the new Subscribe button, you don't even have to leave TorBox to complete your purchase. How neat is that?
![](\\\"https://fb-usercontent.fra1.cdn.digitaloceanspaces.com/1717214936163..png\\\")
API
The
/torrentsendpoints now has proper responses and errors. We are working on updating the entire API with proper responses and errors.
Service
Switched from NGINX Proxy Manager (NPM) to plain NGINX. This was a needed change and was the cause of the random SSL errors, random downtimes and other strange errors. Since changing, things have been working properly and much faster than before. We have concluded that after 6 months of using NPM it is not production ready, especially at the volume we do (roughly 2 million requests per day). This change also allows us to more carefully tune our configurations for speed, and reliability.
Fixed some zip downloads not properly processing.
Adds support for V2 torrents. You can read more about them here. Basically if your torrent magnet has btmh in it rather than (or in addition to) btih, then it is now supported. Previously it would simply say \\\"Torrent rejected by the server\\\".
Better reliability when getting the torrent hash.
Better reliability with debrid links.
Brings back MD5 hashes to files. This was requested by users, as well as for the future of TorBox as we will now be checking for viruses (simple, non-intrusive, and non-removing, acts more as a \\\"hey this torrent has a virus, watch out\\\", not a \\\"this torrent has a virus and you are not allowed to download it\\\" type of vibe), and the simplest way is by MD5 hash.
Website
Fixed web downloads (debrid downloads) not showing progress even though they were downloading just fine.
KNOWN ISSUE: We are aware of the issues with storage.torbox.app. This is a result of not having enough servers to meet the download demands of all of our users during peak hours. We are quickly working on scaling to be able to handle the load. You may notice for a few minutes that the storage is completely inaccessible. We apologize for this inconvenience. We are striving to make TorBox as reliable as possible over the next updates.
\",\n \"markdown\": \"### **Service**\\n- Switched from [NGINX Proxy Manager *(NPM)*](https://nginxproxymanager.com/) to plain [NGINX](https://nginx.org/en/). This was a needed change and was the cause of the random SSL errors, random downtimes and other strange errors. Since changing, things have been working properly and much faster than before. We have concluded that after 6 months of using NPM **it is not production ready**, especially at the volume we do (*roughly 2 million requests per day)*. This change also allows us to more carefully tune our configurations for speed, and reliability.\\n- Fixed some zip downloads not properly processing.\\n- Adds support for V2 torrents. You can read more about them [here](https://blog.libtorrent.org/2020/09/bittorrent-v2/). Basically if your torrent magnet has **btmh** in it rather than (or in addition to) **btih**, then it is now supported. Previously it would simply say \\\"Torrent rejected by the server\\\".\\n- Better reliability when getting the torrent hash.\\n- Better reliability with debrid links.\\n- Brings back MD5 hashes to files. This was requested by users, as well as for the future of TorBox as we will now be checking for viruses (simple, non-intrusive, and non-removing, acts more as a \\\"hey this torrent has a virus, watch out\\\", not a \\\"this torrent has a virus and you are not allowed to download it\\\" type of vibe), and the simplest way is by MD5 hash.\\n\\n### **Website**\\n- Fixed web downloads *(debrid downloads)* not showing progress even though they were downloading just fine.\\n\\n***KNOWN ISSUE: ****We are aware of the issues with *[*storage.torbox.app*](http://storage.torbox.app)*. This is a result of not having enough servers to meet the download demands of all of our users during peak hours. We are quickly working on scaling to be able to handle the load. You may notice for a few minutes that the storage is completely inaccessible. We apologize for this inconvenience. We are striving to make TorBox as reliable as possible over the next updates.*\\n\",\n \"link\": \"https://feedback.torbox.app/changelog/v412\",\n \"created_at\": \"2024-05-26T22:12:58Z\",\n \"id\": \"6653b29673dcb0a16459232b\"\n },\n {\n \"name\": \"v4.1.1\",\n \"html\": \"Website
Allows you to choose whether your large downloads are zipped prematurely or not. Some people preferred to download their files separately, so now there is a setting to change this behavior. By default, TorBox will zip the files prematurely (if there are over 100 files in the download).
This can be changed on a per-torrent basis or globally. To change per-torrent, click \\\"Advanced Settings\\\" in the \\\"Add Torrent\\\" popup. To change globally, simply flip the switch in the settings.
The dashboard will no longer update if you are idle for more than 30 seconds, or if you are out of the tab. This was changed due to bandwidth prices and data being wasted due to people sitting on the dashboard hours at a time simply idling.
If coming back from idle, simply click anywhere on the screen, and you will start receiving updates again.
If you moved away from the tab, simply come back and click anywhere on the screen and you will start receiving updates again.
Downloads will still update by themselves every 60 minutes automatically.
Fixed some support links around the site.
Service
Fixed the somewhat constant \\\"This torrent was rejected by the server\\\" error. This was due to the torrent being added to the server, but the server not reporting it properly. This was solved by simply deleting the torrent if it was already existing, then adding it again. Sorta a brute force method, but it wastes hardly any data, and works, which our users will appreciate.
API
Allows you to send
allow_zipto thecreate_torrentendpoint which tells TorBox not to zip the torrent at all when processing.
Stremio Addon
Does not automatically zip downloads created through Stremio. Previously, users who downloaded season packs or entire show packs would not be able to stream the torrent because it would be automatically zipped by TorBox prematurely as of v4.1. This is no longer the case for downloads created through the Stremio addon.
We have been cooking this update for awhile! Today we are proud to introduce web streaming of any video file, our high speed, private VPN service, as well as some much wanted Stremio addon updates and overall upgrades and updates to the service. Let's get into it.
Website
You are now able to stream any video file through the browser. TorBox has started down the path of transcoding, and media playback, so here we are. In our awesome and beautiful web player, you can stream any video file you have on your TorBox account. This is usually much faster than standard playback of videos as we are transcoding the file, making playback more efficient. Also thanks to Cloudflare's caching it's even faster than normal downloads.
This should be the preferred way to watch content. It works on every device, is fast and is getting more and more features as time goes on.
Full playback is supported, mkv, mp4, you name it, you can play it.
With audio selection, as well as subtitles and subtitle selection, you can be sure you aren't missing out on the streaming experience with TorBox's web player.
If you are keeping tally's, this official means our feature set is equal and greater than Real-Debrid's (and you haven't even gotten to the rest of this update yet). This means that now, not only is TorBox cheaper, but has more features than RD, which is pretty cool.
New tools page. This page has a lot of interesting and useful tools for your journey torrenting with TorBox.
The first tool is a magnet link to torrent file converter. Simply put your magnet link into the text box and click the submit button. After a few seconds, your device will automatically start downloading the newly generated torrent file.
This requires the website to interact with TorBox's API to retrieve metadata about the torrent, which is why it can take a decent amount of time.
The next tool is exactly the opposite, it takes a torrent file, and gives you a magnet link. Unlike the previous converter, this one is nearly instant, giving you a magnet link extremely quickly.
The final tool is a button that generates your VPN WireGuard configuration! This means that you can download the configuration on any device, and use TorBox's VPN on any device as well. You can view all the devices compatible with WireGuard here.
Not only is this VPN free for paid users, it is super fast, doesn't store logs, and unlimited bandwidth. We use Cloudflare servers to route traffic, so your information is private, fast, and always connected near you. This also will increase your download speeds from TorBox as TorBox runs on the Cloudflare network as well. Using the TorBox VPN is like having a direct connection to TorBox's servers. Pretty neat huh?
If you have been having slow downloads, buffering, or anything similar to that, try out the VPN.
You are only able to use this VPN on 4 devices total before devices start swapping spaces. If you add 4 devices, and try to add one more, the first device you added will be swapped with the newest 5th device.
You have unlimited bandwidth (8TB per month, up to 10x more if requested) so go crazy with it!
Service
Any torrents over 100 files large will now be zipped prematurely. This saves you and TorBox bandwidth, and decreases the risk of downloads failing when downloading a zip later on. This does come with a penalty in processing time, as the server needs time to prematurely zip all of those files. At least it is doing it in a safe environment, where nothing will break compared to a high bandwidth and fluctuating environment.
All paid users have access to our TorBox VPN. Enjoy!
Mostly fixed downtime issues. Still working on some storage problems, sorry, you likely won't notice as it only happens for a split second once or twice a day.
API
New streaming endpoints. Allows you to create streams, get stream info, and more. This is a more efficient way of streaming your video content through TorBox, saves bandwidth and more.
At the time of writing, there are no docs yet, we are working on documentation for everything, and this is on the lowest priority of the list.
Torrent searches should produce more results. Previously we were not using as efficient Jackett API's, but now, it should be equal to the results searched from the TorBox dashboard. Yes, we run on about 8 Jackett instances to support all of these searches.
Stremio Addon
Instead of just viewing your downloaded content in the \\\"Your Media\\\" discovery page, you can now find your content in their respective titles! Say you download a file from anywhere named \\\"Big.Bunny.4k.mp4\\\", you can now search Stremio like normal and open the Cinemeta page, and find the file in there labeled \\\"TorBox (Your Media) (Resolution)\\\". This feature is extremely similar to Debrid Search, which was a heavily requested feature from our users.
Matching isn't always perfect. Since it can only rely on file names, if the names are bad, or look nothing like the content, such as only being \\\"S01E02\\\" rather than \\\"Show S01E02\\\" then TorBox won't be able to categorize it.
Compatible with Usenet and Torrents.
Compatible with any catelog!
This now allows you to use subtitles on your own content using your favorite subtitle addons!
Search should be at least a little bit faster. On average we have gathered about 3 seconds time in total.
When the data is already cached, meaning someone has already clicked on that title, time can be as low as 1 second.
When the data needs to be scraped, it can go all the way up to 30ish seconds to get initial data. If you aren't happy with the data it delivers, come back in about 5 minutes to get the data that was scraped in the background.
Service
Fixes queued downloads not being added in order. Queued downloads will now be added from oldest to newest.
Website
Retries when adding new torrents from the dashboard. This will try to add your torrent up to 5 times before erroring out. Just in case.
Same with Usenet and Debrid/Web Downloads.
Fixes bug with seeding settings not being correct when adding a torrent. This was due to the state not being correct on first load. Always worked if you went to a different page and came back. Only affected new sessions.
Speeds up loading of settings page settings from cloud up to 200%. Meaning it is 2x faster.
The settings page buttons look a bit better on smaller screens.
Changed text of Discord Link button. When you are already linked, you can click the button again to re-link, but users weren't aware, so we added a little bit of text to let you know.
Allows unlinking your Discord account from TorBox.
Service
Allows you to purchase additional slots for your TorBox account. This means that instead of being limited to 3, 5 or 10 download/seeding slots you are able to purchase as many as you want. Most people won't ever need to purchase additional slots, but if you are a power user, you might want to.
Reduces price of yearly Standard plan to $55. Previously it was at $60, which is just the 12 month price. With this change you get a free month for purchasing yearly, which matches the rest of the subscriptions.
Website
Adds section in Addons tab for the concurrent downloads addon. Simply shows options for purchasing.
All subscriptions are shown inside the \\\"Manage Subscription\\\" button from the dashboard, which allows you to manage all of your current and future TorBox subscriptions.
If you get a warning about being over the limit, TorBox will show the correct limit, instead of 10, for whatever reason.
Website
Adds invisible retries when requesting downloads. This is due to the API being somewhat unreliable for some users. This gives the API 5 tries before failing.
This is most useful when batch requesting links as hitting the API with 300 requests at the same time can lead to failures on some files.
Adds AirPlay, Google Cast, PiP, and Download buttons on the in-browser video player.
If a link fails to retrieve, it doesn't do any further action.
Before, it would still open a new tab, or copy \\\"null\\\" to your clipboard. This has now been fixed.
Stremio Addon
Speeds up Stremio addon search speeds by over 50%. This is due to our cache having a low expiry, meaning that even if someone else searched less than an hour ago for the same streams, it would force you to research for them.
Search API
Uses Torznab searches for better accuracy rather than using the default Jackett API. Expect more results, better and faster results from the API.
WebDAV
Fixes playing items on Kodi when using the flattened structure.
Makes folders more readable by artificially diving down one folder to see the download name.
Before the webDAV would show the hash of the download, which is how we store the files, but it made it hard to pick and choose items.
Should improve reliability on other webDAV clients as well.
Website
Adds dialogue when there are no search results in the NZB search so it doesn't look broken.
Stremio Addon
Fixes user media not showing any streams on TV clients.
Website
Speeds up dashboard loading speeds by 3x and even 4x in some cases!
Reduced calls to database.
Reduced recursion.
On Usenet downloads and Web downloads on small screens, the buttons when you click on a download is dropped down instead of squished together.
Sorts Usenet downloads and Web downloads and puts active ones at the top.
Adds surveys. Surveys are completely anonymous and not required in any way. If you want to answer them, that will help us out a lot, otherwise simply close them and they won't show up.
Service
Fixed large zips failing to download all of the way.
WebDAV
WebDAV is now much faster when listing files and directories.
Stremio Addon
Stremio is now much faster when listing streams.
Stremio now shows cached status properly.
Improved sorting of streams.
Sorted by cached at the very top with torrents being the top of the list.
Torrents are sorted above usenet streams.
Torrents are sorted by seeders, then resolution, then size.
Usenet streams are sorted by age, then resolution, then size.
The sorting may not be as expected, as each stream is assigned a \\\"want\\\" score, with high seeders being more valuable than resolution, than size. Same with Usenet but seeders as age. This means that it is possible that a low resolution, high seeder file will come above a low seeder, 1080p stream.
Website
Web downloads and Usenet downloads now update properly on the dashboard.
Service
Adds more hosters to debrid/web downloads.
API
Adds error for Free or Essential users adding private torrents.
Private torrents are limited to Standard and Pro users.
Website
Adds searching for NZB's directly inside TorBox, just like the torrents.
Searching is not instant or as you type.
You have to be pretty specific when you search.
Not the most accurate way of getting items, such as searching by episode, is hard to do right now. Eventually search will be receiving a full makeover.
Service
Fixes RSS feeds acting strange. They are now quite reliable and do exactly what they are supposed to now.
Fixes speed test page to have current servers.
WebDAV
Uses Cheroot as the web server rather than Uvicorn for better compatibility and stability with the WSGI web server implementation. This will improve download speeds, connection times, and overall stability.
Stremio Addon
On Instant (Cached) streams, it shows the resolution for easy viewing.
API
Adds translation to Real-Debrid API so it is easy to add TorBox to projects that have already integrated Real-Debrid's APIs.
Adds searching by query to Main API. API DOCS.
Adds searching by query to Usenet Search API. API DOCS.
Stremio Addon
Gets more and strict results for series. Searches by episode from the search API. That way, for series with large numbers of seasons and episodes, you can get everything you need.
Adds age to description of Usenet streams so you can see how old the stream is.
Search API
Allows searching by Season and Episode when searching on either the torrents endpoint or Usenet endpoint. API DOCS.
Service
Fixed long connection times to the storage servers. Before there would 502 Gateway Timeouts and such. Now connections should be under 10 seconds max (depending on your location). US location was tested with about 5 seconds, Germany with 2 seconds, and Netherlands with around 1 second to connection.
Made zipped files more efficient and works with large files. Before there would be a limit of about 100gb per file, now there is no limit!
Fixed a race condition where Usenet downloads will be finished before the record is added to the database, meaning the completed download doesn't know it exists yet. Crazy situation, but it is now fixed meaning that any sized downloads work with our insane Usenet download speeds.
This is TorBox's largest update to date. Introducing v4.0, where the major features include, Usenet, Web Downloads (Debrid), a rewritten storage API, and a more stable and reliable service. Along with major features, our infrastructure has changed significantly, and we are pretty much at endgame setup, so things are just scaling up from here.
Website
Adds a Add NZB button to the dashboard. This allows you to add an NZB link or file that will then download the files from the Usenet. The files received from usenet will then be available to download.
We will talk more about usenet downloads in the service section.
This button, although visible, will not be usable to non-Pro members. It will instead ask you to upgrade to Pro if you hover over it.
Adds an Add Web Link to the dashboard. This allows you to add any link and it will be downloaded to your account. This is commonly used as a debrid for things such as 1Fichier, RapidGator, YouTube, Google Drive and more. The file will transfer to your account and will be available to download, just like a torrent.
We will talk more about web downloads in the service section.
This button, although visible will not be usable to free users. It will instead ask you to upgrade to a paid plan if you hover over it.
Web Downloads are shown on the dashboard.
They are shown below the torrents for now. We need to combine them all into the same list, it is some internal frontend issue, we will add sorting and filtering as well soon.
You are not able to pause web downloads from the dashboard. Once a download has been started, there is no stopping it, unless you delete it.
Usenet downloads are shown on the dashboard.
Just like web downloads, they are shown below torrents due to internal layouts of the dashboard. This will be addressed soon.
You are able to pause and resume usenet downloads, although why would you want to?
Usenet and Web Downloads have the same look and feel as the torrents. They also are just as reactive. Download speeds will count towards the graph on the dashboard as well.
Everything basically works the exact same as the torrents. Just click on the download button and you will be brought to the familiar download page to choose the files, and how you want to download the files.
Fixed Dial on the left side, which shows the quota free users have left. This has been redone to show fancy colors depending on how many you have left.
Changed how the avatar/user section is laid out.
There is no longer a server name, or server IP as internally, users aren't assigned to a server anymore. We will talk about that more in the service section.
The space has no been replaced with some cool stats.
You can now see how much data you have downloaded (in torrents, usenet downloads and web downloads, not from TorBox itself).
You can now see how much data you have uploaded (data your torrents have seeded).
The above data is now used to calculate an overall ratio. There is no risk for having a low ratio or anything, but it is just a cool stat to see. If your ratio is under 1, a sad face will show. If your ratio is over 1, but under 5, a cool face will show. If ratio over 5, there will be a golden crown to show how much of a king (or queen) you are. Basically this is for bragging rights.
We will eventually show more dialed in data, such as data for today, data for the week, or data for the month.
Please note: this data started with the update. If you were or are a previous TorBox user, you are still starting fresh, we just don't have data from previous to this update.
Updated Pricing page to reflect changes in free plan and changes to the upper plans.
On smaller screens, to avoid overflows, \\\"Add Torrent\\\" is simply \\\"Torrent\\\". We might change how this looks on smaller screens in the future, as we aren't exactly happy with this change.
Service
Added the new Usenet feature. This allows you to access the Usenet without paying for any extra subscritpions. We handle everything from searching (soon), providers, storage and integration into Stremio and the rest of TorBox.
Files are cached just like torrents, so if it is a popular usenet download, it will likely be cached. If it isn't it will download just like normal.
Currently we use Eweka and Newsdemon as providers. We are going to add blocks soon, and if needed, more providers if users run into issues.
We use special 20gbit servers to download these usenet files. They are downloaded to enterprise NVME drives and then extracted like normal to the drives. They are then cached to our mass storage servers.
Usenet is only available to Pro users. If you want to use Usenet, make sure to upgrade to our Pro plan for only $10/mo! We don't offer this to free or paid plans as it costs quite a bit for us to offer Usenet.
Searching is coming soon. We already search for the Stremio addon, we just need to make it available on the website.
We use multiple indexers, and have been collecting some for awhile. This will allow you to use the best quality, and least likely to fail files. We won't say which ones specifically we use, but just know they are elite and the best indexers you can get access to.
To address indexer bans: we don't have to worry about getting banned. Files are locked down, and inaccessible to the public (meaning you have to add the files through the site or Stremio to use them). We cache results, so the API's aren't being hit over and over again. Only Pro users are able to use this feature, even using our API, and since it is only a smaller subset of our users, the usage won't be as high as if we offered it to all paid users.
We use a custom self-hosted instance of SABNzbd and we actively sponsor them as well through their PayPal. Thanks to the team for such an awesome and extendable usenet downloader.
Added the new Web Download (debrid) feature. This allows you to download pretty much any file on the internet without the extra subscription. Just like with Usenet, we handle everything, giving you the most seamless experience possible.
Just like Usenet and Torrents, web downloads (debrid downloads, we refer to them as web downloads) are cached and are instantly available for anyone who downloads them afterwards.
Please note: we don't have a hoster list or a site list yet, that will come soon.
Usage is pretty much unlimited, but of course, there it all falls under fair use, and will count as an active download until complete, so depending on your plan, you can only download so many at a time. This is the same for all types of downloads. We are adding addons soon that will improve these limits for a small price.
We use the same 20gbit servers to download the web downloads, so you can be sure that speeds will be quick to download.
Web Downloads are only available to paid plans. Any paid plan has access to web downloads. We don't offer this to free users due to abuse.
We use a custom/modified self-hosted Pyload instance and its API to download your web downloads. Thanks to the team for an awesome service. We have donated to the team through their PayPal as thanks for an awesome service.
All web downloads are downloaded through a residential proxy meaning that any file is downloadable, and the server won't get banned from websites or file hosters.
Free user's limitations have been increased. This was done to increase conversion, as the free plan was not meant to be a real plan, rather a trial. We understand that this might be upsetting. In the future, when TorBox becomes financially stable, we can think about bringing these limits back up.
Max size per torrent has been reduced to 50gb, down from 100gb per torrent.
Torrent transfer speed has been reduced to 250mbps (31.25MB/s on the dashboard), down from 1gbps (125MB/s on the dashboard).
6 hour seeding has been reduced to 6 hours, down from 24 hours.
In return, all paid plans have been boosted.
Essential and Standard now gets
Unlimited web downloads (access to web downloads).
Increase to 200gb max torrent size per torrent, from 100gb max torrent size. Many users were complaining it was too small, so we have listened and increased the max size.
Pro gets
Unlimited web downloads (access to debrid).
Unlimited usenet downloads (access to usenet).
We now have switched from our previous server provider, which was Leaseweb. They were mostly good to work with, but the amount we were spending on bandwidth was just way too much, so we have switched. We are very happy with our new providers and are very happy with their services. You can view more about our infrastructure at https://hetrix.torbox.app.
Storage
The storage API has been rewritten in Rust! Previously it had been written in Python, but this was not fast enough and we noticed a difference of over 50% speed difference with Python (afterwards) in a production highly concurrent environment. Obviously this is not good, so we went ahead and rewrote the entire thing in Rust. In a server to server environment (different data centers, both 10gbit), we noticed speeds hitting over 3gbps over Rust (Actix), whereas using Python (FastAPI), we were maxing out around 1gbps. Of course this is in a perfect environment. Even so, in real-world tests we regularly hit 1.5gbps or higher (concurrently, other users were downloading at the same time).
Apart from the transfer speeds, this also increased zipped download speeds, which is intensely I/O heavy, we have noticed an increase in over 35% speeds, thanks to Rust being highly focused on concurrent threads.
Please note: while downloads are fast, that's only if you can access them. In a few cases, so far around 20% of downloads fail due to the file not existing. This is due to file information not being propagated to all servers in fast enough time, meaning you might access the file over a server that doesn't know the file exists yet. This usually only happens to brand new transfers that just got marked as \\\"Download Ready\\\" or \\\"Cached\\\". We are working on a solution to this complex issue.
Stremio Addon
The Stremio addon now has the ability to watch Usenet content if you are on the Pro plan. These will show up as streams, labeled with the type \\\"Usenet\\\".
Torrents now show a type of \\\"Torrents. Usenet downloads now show a type of \\\"Usenet\\\" so you can distinguish them.
If you are a free user using the addon. There will be a small advertisement at the top of the streams asking you to subscribe. It's small and sort of out of the way, and even offers a discount!
Usenet media files are shown in the \\\"Your Media\\\" section in the Discover tab.
Please note: while movies and short seasons, and popular content has many different options for streams, some edge cases or very large series will not have many streams. We are working on a solution for that. It will be fixed soon.
WebDAV
Fixes minor bugs with WebDAV not being able to show all of your files.
Shows web downloads and Usenet downloads in WebDAV allowing you to access them just like torrents.
Search API
The search API now has the (
/usenet) endpoint which allows you to search for NZB's on the usenet using our indexers. You can read more about that here https://search-api.torbox.app/usenet. API DOCS.Like written before. No NZB files are accessible. You can see the link, but they are null-routed outside of our network, thanks to Tailscale. For example, here is a link to an NZB: http://100.126.180.44:4010/getnzb/user/4443484788790234930. Good luck accessing that. Yes, we use NZBHydra. Thanks to their team for the awesome search, we sponsor them as thanks as well. Keep doing awesome stuff.
API
The API Docs page looks a little different. We have added 2 other TorBox API's to the collection, and this allows you to view them all. You can view the new API docs at https://api-docs.torbox.app. Any old links will not work.
Added endpoints for Usenet. These endpoints mostly mirror how the torrent endpoints work. You can read more about those here.
Added endpoints for Web Downloads. Like Usenet, these mostly mirror the torrent endpoints, except for a few parameter changes. You can read more about those here.
The Stats endpoint (
/api/stats) now includes a lot more data such as total_downloads, total_bytes_downloaded, active_torrents, and more interesting data. This data is updated once every hour.Please note: RSS Feeds refreshing has been disabled for now. They will not automatically update. There are a few things wrong with them internally, as they have not been developed as not many users use them, so they have fallen behind in updates. We will spend some time making sure they are awesome again in the following updates.
That pretty much wraps up v4.0. There are quite a few bugs for us to fix, so I guess we will get started on that! Enjoy the new update and let us know if you have any issues! Thank you all for sticking with us through the low points, because it's now only up from here on out!
\",\n \"markdown\": \"This is TorBox's largest update to date. Introducing v4.0, where the major features include, Usenet, Web Downloads (Debrid), a rewritten storage API, and a more stable and reliable service. Along with major features, our infrastructure has changed significantly, and we are pretty much at endgame setup, so things are just scaling up from here.\\n### ***Website***\\n- Adds a Add NZB button to the dashboard. This allows you to add an NZB link or file that will then download the files from the Usenet. The files received from usenet will then be available to download.\\n - We will talk more about usenet downloads in the service section.\\n - This button, although visible, will not be usable to non-Pro members. It will instead ask you to upgrade to Pro if you hover over it.\\n \\n- Adds an Add Web Link to the dashboard. This allows you to add any link and it will be downloaded to your account. *This is commonly used as a debrid for things such as 1Fichier, RapidGator, YouTube, Google Drive and more*. The file will transfer to your account and will be available to download, just like a torrent.\\n - We will talk more about web downloads in the service section.\\n - This button, although visible will not be usable to free users. It will instead ask you to upgrade to a paid plan if you hover over it.\\n \\n- Web Downloads are shown on the dashboard.\\n - They are shown below the torrents for now. We need to combine them all into the same list, it is some internal frontend issue, we will add sorting and filtering as well soon.\\n - You are not able to pause web downloads from the dashboard. Once a download has been started, there is no stopping it, unless you delete it.\\n \\n- Usenet downloads are shown on the dashboard.\\n - Just like web downloads, they are shown below torrents due to internal layouts of the dashboard. This will be addressed soon.\\n - You are able to pause and resume usenet downloads, although why would you want to?\\n \\n- Usenet and Web Downloads have the same look and feel as the torrents. They also are just as reactive. Download speeds will count towards the graph on the dashboard as well.\\n- Everything basically works the exact same as the torrents. Just click on the download button and you will be brought to the familiar download page to choose the files, and how you want to download the files.\\n- Fixed Dial on the left side, which shows the quota free users have left. This has been redone to show fancy colors depending on how many you have left.\\n- Changed how the avatar/user section is laid out.\\n - There is no longer a server name, or server IP as internally, users aren't assigned to a server anymore. We will talk about that more in the service section.\\n - The space has no been replaced with some cool stats.\\n - You can now see how much data you have downloaded (in torrents, usenet downloads and web downloads, not from TorBox itself).\\n - You can now see how much data you have uploaded (data your torrents have seeded).\\n - The above data is now used to calculate an overall ratio. There is no risk for having a low ratio or anything, but it is just a cool stat to see. If your ratio is under 1, a sad face will show. If your ratio is over 1, but under 5, a cool face will show. If ratio over 5, there will be a golden crown to show how much of a king (or queen) you are. Basically this is for bragging rights.\\n - We will eventually show more dialed in data, such as data for today, data for the week, or data for the month.\\n - ***Please note:**** this data started with the update. If you were or are a previous TorBox user, you are still starting fresh, we just don't have data from previous to this update.*\\n \\n \\n- Updated Pricing page to reflect changes in free plan and changes to the upper plans.\\n- On smaller screens, to avoid overflows, \\\"Add Torrent\\\" is simply \\\"Torrent\\\". We might change how this looks on smaller screens in the future, as we aren't exactly happy with this change.\\n\\n### ***Service***\\n- Added the new Usenet feature. This allows you to access the Usenet without paying for any extra subscritpions. We handle everything from searching (soon), providers, storage and integration into Stremio and the rest of TorBox.\\n - Files are cached just like torrents, so if it is a popular usenet download, it will likely be cached. If it isn't it will download just like normal.\\n - Currently we use [Eweka](https://www.eweka.nl/en) and [Newsdemon](https://www.newsdemon.com/) as providers. We are going to add blocks soon, and if needed, more providers if users run into issues.\\n - We use special *20gbit servers* to download these usenet files. They are downloaded to enterprise NVME drives and then extracted like normal to the drives. They are then cached to our mass storage servers.\\n - **Usenet is only available to Pro users.** If you want to use Usenet, make sure to upgrade to our Pro plan for only $10/mo! We don't offer this to free or paid plans as it costs quite a bit for us to offer Usenet.\\n - Searching is coming soon. We already search for the Stremio addon, we just need to make it available on the website.\\n - We use multiple indexers, and have been collecting some for awhile. This will allow you to use the best quality, and least likely to fail files. We won't say which ones specifically we use, but just know they are elite and the best indexers you can get access to.\\n - *To address indexer bans: we don't have to worry about getting banned. Files are locked down, and inaccessible to the public (meaning you have to add the files through the site or Stremio to use them). We cache results, so the API's aren't being hit over and over again. Only Pro users are able to use this feature, even using our API, and since it is only a smaller subset of our users, the usage won't be as high as if we offered it to all paid users.*\\n \\n - We use a custom self-hosted instance of SABNzbd and we actively sponsor them as well through their PayPal. Thanks to the team for such an awesome and extendable usenet downloader.\\n \\n- **Added the new Web Download (debrid) feature.** This allows you to download pretty much any file on the internet without the extra subscription. Just like with Usenet, we handle everything, giving you the most seamless experience possible.\\n - Just like Usenet and Torrents, web downloads (debrid downloads, we refer to them as web downloads) are cached and are instantly available for anyone who downloads them afterwards.\\n - ***Please note:**** we don't have a hoster list or a site list yet, that will come soon.*\\n - Usage is pretty much *unlimited*, but of course, there it all falls under fair use, and will count as an active download until complete, so depending on your plan, you can only download so many at a time. This is the same for all types of downloads. We are adding addons soon that will improve these limits for a small price.\\n - We use the same *20gbit servers* to download the web downloads, so you can be sure that speeds will be quick to download.\\n - **Web Downloads are only available to paid plans.** Any paid plan has access to web downloads. We don't offer this to free users due to abuse.\\n - We use a custom/modified self-hosted [Pyload](https://pyload.net/) instance and its API to download your web downloads. Thanks to the team for an awesome service. We have donated to the team through their PayPal as thanks for an awesome service.\\n - All web downloads are downloaded through a residential proxy meaning that any file is downloadable, and the server won't get banned from websites or file hosters.\\n \\n- *Free user's limitations have been increased*. This was done to increase conversion, as the free plan was not meant to be a real plan, rather a trial. We understand that this might be upsetting. In the future, when TorBox becomes financially stable, we can think about bringing these limits back up.\\n - **Max size per torrent has been reduced to 50gb**, down from 100gb per torrent.\\n - **Torrent transfer speed has been reduced to 250mbps** (31.25MB/s on the dashboard), down from 1gbps (125MB/s on the dashboard).\\n - **6 hour seeding has been reduced to 6 hours**, down from 24 hours.\\n \\n- **In return, all paid plans have been boosted.**\\n - Essential and Standard now gets\\n - **Unlimited web downloads** (access to web downloads).\\n - I**ncrease to 200gb max torrent size per torrent**, from 100gb max torrent size. Many users were complaining it was too small, so we have listened and increased the max size.\\n \\n - Pro gets\\n - **Unlimited web downloads** (access to debrid).\\n - **Unlimited usenet downloads** (access to usenet).\\n \\n \\n- We now have switched from our previous server provider, which was Leaseweb. They were mostly good to work with, but the amount we were spending on bandwidth was just way too much, so we have switched. We are very happy with our new providers and are very happy with their services. You can view more about our infrastructure at [https://hetrix.torbox.app](https://hetrix.torbox.app).\\n\\n### ***Storage***\\n- **The storage API has been rewritten in Rust!** Previously it had been written in Python, but this was not fast enough and we noticed a difference of over 50% speed difference with Python (afterwards) in a production highly concurrent environment. Obviously this is not good, so we went ahead and rewrote the entire thing in Rust. In a server to server environment (different data centers, both 10gbit), we noticed speeds hitting over **3gbps** over Rust ([Actix](https://actix.rs/)), whereas using Python ([FastAPI](https://fastapi.tiangolo.com/)), we were maxing out around 1gbps. Of course this is in a perfect environment. Even so, in real-world tests we regularly hit 1.5gbps or higher (concurrently, other users were downloading at the same time).\\n - Apart from the transfer speeds, this also increased zipped download speeds, which is intensely I/O heavy, we have noticed an increase in over 35% speeds, thanks to Rust being highly focused on concurrent threads.\\n \\n- ***Please note:**** while downloads are fast, that's only if you can access them. In a few cases, so far around 20% of downloads fail due to the file not existing. This is due to file information not being propagated to all servers in fast enough time, meaning you might access the file over a server that doesn't know the file exists yet. This usually only happens to brand new transfers that just got marked as \\\"Download Ready\\\" or \\\"Cached\\\". We are working on a solution to this complex issue.*\\n\\n### ***Stremio Addon***\\n- The Stremio addon now has the ability to watch Usenet content if you are on the Pro plan. These will show up as streams, labeled with the type \\\"Usenet\\\".\\n- Torrents now show a type of \\\"Torrents. Usenet downloads now show a type of \\\"Usenet\\\" so you can distinguish them.\\n- If you are a free user using the addon. There will be a small advertisement at the top of the streams asking you to subscribe. It's small and sort of out of the way, and even offers a discount!\\n- Usenet media files are shown in the \\\"Your Media\\\" section in the Discover tab.\\n- ***Please note:**** while movies and short seasons, and popular content has many different options for streams, some edge cases or very large series will not have many streams. We are working on a solution for that. It will be fixed soon.*\\n\\n### ***WebDAV***\\n- Fixes minor bugs with WebDAV not being able to show all of your files.\\n- Shows web downloads and Usenet downloads in WebDAV allowing you to access them just like torrents.\\n\\n### ***Search API***\\n- The search API now has the** **(`/usenet`) endpoint which allows you to search for NZB's on the usenet using our indexers. You can read more about that here [https://search-api.torbox.app/usenet](https://search-api.torbox.app/usenet). [API DOCS.](https://www.postman.com/wamy-dev/workspace/torbox/collection/29572726-6fbbb607-40cc-440e-b18f-325c563efff4)\\n - Like written before. No NZB files are accessible. You can see the link, but they are null-routed outside of our network, thanks to Tailscale. For example, here is a link to an NZB: [http://100.126.180.44:4010/getnzb/user/4443484788790234930](http://100.126.180.44:4010/getnzb/user/4443484788790234930). Good luck accessing that. Yes, we use [NZBHydra](https://github.com/theotherp/nzbhydra2). Thanks to their team for the awesome search, [we sponsor them as thanks as well](https://github.com/orgs/TorBox-App/sponsoring). Keep doing awesome stuff.\\n \\n\\n### ***API***\\n- The API Docs page looks a little different. We have added 2 other TorBox API's to the collection, and this allows you to view them all. You can view the new API docs at [https://api-docs.torbox.app](https://api-docs.torbox.app). Any old links will not work.\\n- Added endpoints for Usenet. These endpoints mostly mirror how the torrent endpoints work. [You can read more about those here](https://www.postman.com/wamy-dev/workspace/torbox/folder/29572726-0ee58f08-0056-4cab-af51-38d758769aeb?ctx=documentation).\\n- Added endpoints for Web Downloads. Like Usenet, these mostly mirror the torrent endpoints, except for a few parameter changes. [You can read more about those here.](https://www.postman.com/wamy-dev/workspace/torbox/folder/29572726-533ea9ba-d6d6-42f2-af4b-1132d69054b3?ctx=documentation)\\n- The Stats endpoint (`/api/stats`) now includes a lot more data such as *total\\\\_downloads*, *total\\\\_bytes\\\\_downloaded*, *active\\\\_torrents*, and more interesting data. This data is updated once every hour.\\n- ***Please note:**** RSS Feeds refreshing has been disabled for now. They will not automatically update. There are a few things wrong with them internally, as they have not been developed as not many users use them, so they have fallen behind in updates. We will spend some time making sure they are awesome again in the following updates.*\\n\\nThat pretty much wraps up v4.0. There are quite a few bugs for us to fix, so I guess we will get started on that! Enjoy the new update and let us know if you have any issues! Thank you all for sticking with us through the low points, because it's now only up from here on out!\\n\",\n \"link\": \"https://feedback.torbox.app/changelog/v40\",\n \"created_at\": \"2024-04-10T05:11:31Z\",\n \"id\": \"6615c20f026bad3f2b0a1cef\"\n },\n {\n \"name\": \"v3.7.1\",\n \"html\": \"Website
Fancies up Quick Add Page.
Adds advanced settings to Quick Add page, that way, when sharing torrents, you can still use the same settings as adding through the dashboard.
Fixes right click issue when deleting a torrent, the menu used to stay persisted. Whenever you clicked on anything in the menu, the menu and the dialogue would also close.
Made cached torrents sort to the bottom, while new and active downloads are at the top. A lot of users were complaining about how many torrents are piling up, so now they are sort of out of the way.
Fixed a bunch of small bugs on the website.
Fixes adding torrents from search requiring 2 clicks.
Makes MFA code entry look better.
Service
Fixes duplicate torrents showing up when adding a duplicate torrent of a download ready torrent.
Fixes some cached downloads not being part of a folder.
Fixes some torrents failing processing due to seeding restrictions.
Stremio Addon
Fixes some user's lists from not showing up due to incompatible characters being present.
Fixes needed to click on video twice for Instant content (some, there is a timing issue going on that needs to be figured out).
Fixes getting an error the first time watching Instant content (you will get a video, if the content does not start playing).
WebDAV
Fixes cached torrents not showing up in WebDAV properly.
Along with this small update, we have hit a pretty big milestone, 10,000 users! Combined with this, we recently hit 30,000 downloads (this means the number of torrents added)! We also are adding a pretty large feature, which is not exactly a breaking change, but changes how TorBox seeds torrents from now on. This also introduces a lot of cool UI changes and features, so read more below!
Website
Adds new pricing page! This allows you to fully view the pricing and makes for easier comparison between plans.
Changed wording in footer.
Changed wording of some CTA.
Changes color of Manage Subscription button on Dashboard to have more contrast.
Changes MFA code entry form to look a lot nicer and more familiar.
New setting for changing caching settings for torrents added. This allows you to choose 1 of 3 new seeding presets.
Auto. This is the default. Keeping on auto, means that TorBox will decide what torrents will be seeded. TorBox will take into consideration factors such as if the torrent is private, torrent health, seeders, peers and more to make an informed decision whether to seed the torrent or not.
NOTE: TorBox will seed more often than not in auto mode.
Always. This is the option you choose if you want all of your torrents to seed.
Never. This is the option you choose if you want all of your torrents to not seed.
New setting for changing caching settings for torrents added through the Stremio addon. This is exactly like the above setting, except that it is specifically for Stremio torrents. This allows you to have even more flexibility when adding torrents.
New Advanced section in the New Torrent popup/dialog that will have additional settings when adding torrents.
New drop down in this section that is exactly like the above settings, except for overriding your settings for specifically this torrent. If for example, you usually add private torrents, and this is a public torrent, you can make this specific torrent to not seed, but keep your default setting at always seed.
Removed button asking you to enable notifications on mobile. Most mobile devices don't support push notifications from the browser anyways, so the button was simply removed. If you want notifications on your device, download the mobile app!
Service
Now sends a notification on sign in. It tells you the IP and device that was signed into. This way you can keep your account secure if you notice that this wasn't you signing in.
Allowing users to not seed instantly opens up a active torrent slot, and makes the torrent cached rather than seeding and taking up an active slot.
API
Adds ability to specify an option on the /createtorrent path for seeding.
When sending a multipart form, if you want to specify a seeding setting, send use the key name, seed. Accepted values are numbers from 1-3. 1 meaning auto, 2 meaning seed, 3 meaning don't seed.
Search API
Adds /search/<<query>> route which allows you to search by any type of query and return metadata for the results.
Uses Meilisearch in the background so it is super fast, accurate, and you are able to search for literally anything, titles, aliases in other languages, actors, characters, and more.
Adds tutorial endpoints such as for /meta, /torrents and /search, which tells you all about the endpoints.
Usenet coming next!
\",\n \"markdown\": \"Along with this small update, we have hit a pretty big milestone, 10,000 users! Combined with this, we recently hit 30,000 downloads (this means the number of torrents added)! We also are adding a pretty large feature, which is not exactly a breaking change, but changes how TorBox seeds torrents from now on. This also introduces a lot of cool UI changes and features, so read more below!\\n### **Website**\\n- [Adds new pricing page!](https://torbox.app/pricing) This allows you to fully view the pricing and makes for easier comparison between plans.\\n- Changed wording in footer.\\n- Changed wording of some CTA.\\n- Changes color of Manage Subscription button on Dashboard to have more contrast.\\n- Changes MFA code entry form to look a lot nicer and more familiar.\\n- [Changes about page graphic to be a little more fancy.](https://torbox.app/about)\\n- New setting for changing caching settings for torrents added. This allows you to choose 1 of 3 new seeding presets.\\n - **Auto.** This is the default. Keeping on auto, means that TorBox will decide what torrents will be seeded. TorBox will take into consideration factors such as if the torrent is private, torrent health, seeders, peers and more to make an informed decision whether to seed the torrent or not.\\n - **NOTE: TorBox will seed more often than not in auto mode.**\\n \\n - **Always.** This is the option you choose if you want all of your torrents to seed.\\n - **Never.** This is the option you choose if you want all of your torrents to not seed.\\n \\n- New setting for changing caching settings for torrents added through the Stremio addon. This is exactly like the above setting, except that it is specifically for Stremio torrents. This allows you to have even more flexibility when adding torrents.\\n- New Advanced section in the New Torrent popup/dialog that will have additional settings when adding torrents.\\n - New drop down in this section that is exactly like the above settings, except for overriding your settings for specifically this torrent. If for example, you usually add private torrents, and this is a public torrent, you can make this specific torrent to not seed, but keep your default setting at always seed.\\n \\n- Removed button asking you to enable notifications on mobile. Most mobile devices don't support push notifications from the browser anyways, so the button was simply removed. If you want notifications on your device, download the mobile app!\\n\\n### **Service**\\n- Now sends a notification on sign in. It tells you the IP and device that was signed into. This way you can keep your account secure if you notice that this wasn't you signing in.\\n- Allowing users to not seed instantly opens up a active torrent slot, and makes the torrent cached rather than seeding and taking up an active slot.\\n\\n### **API**\\n- Adds ability to specify an option on the */createtorrent* path for seeding.\\n - When sending a multipart form, if you want to specify a seeding setting, send use the key name, *seed*. Accepted values are numbers from 1-3. *1 meaning auto, 2 meaning seed, 3 meaning don't seed.*\\n \\n\\n### **Search API**\\n- Adds */search/<Website
Adds a context menu for torrents. Allows you to right-click (or hold on mobile) a torrent to bring up additional options, as well as the standard options for the torrent.
The standard options are the same as simply clicking on the torrent normally.
The new options are under the \\\"More Tools\\\" section. Simply hover over this button to show the new options.
There are 4 new options (2 for cached downloads).
Copy ID. This simply copies the ID of the torrent for use elsewhere. Maybe for sharing with support, or using with the API for one-off requests. This is available for cached downloads as well.
Copy hash. Very similar to copying the ID, and used for likely the same things. This is available for cached downloads as well.
Copy magnet. Simply copies the magnet link for the torrent. Allows you to get the magnet even for torrents created using torrent files. Sends a network request to get the information from the API so it may not be copied instantly. This is not compatible with cached torrents and are not shown.
Export .torrent. Downloads the torrent file for the torrent. Allows you to get the torrent file even for torrents created using magnet links. Sends a network request to get the information from the API so it may not be copied instantly. This is not compatible with cached torrents and are not shown.
Adds a new option for downloading. Instead of downloading using zips, you can now download links separately but in batches.
To use, click on the clipboard, next to the folder icon. These icons are located at the very top of folders. (If you don't know what button does what, simply hovering over it will give you some info).
![](\\\"https://fb-usercontent.fra1.cdn.digitaloceanspaces.com/1710443142286..png\\\")
It will begin to load while it retrieves the links for you. Depending on how many files are inside the folder, it could take awhile. Once it is complete it will open up the popup that shows you all of the files that were inside the folder you selected as well as some options.
Click the check boxes to choose which files are selected or not.
You can click on the names of the files to instantly start downloading that file, or copy the link.
These options do the following:
Copy All, copies all the download links regardless of what are selected.
Copy Selected, only copies the links that are selected.
Download All, downloads all the links regardless of what are selected. (Make sure to have popups enabled or else only one link will open).
Download Selected, downloads only the links that are selected. (Make sure to have popups enabled or else only one link will open).
![](\\\"https://fb-usercontent.fra1.cdn.digitaloceanspaces.com/1710443255203..png\\\")
API
Adds new endpoint for exporting torrent magnets and torrent files. This is useful for users who want to share a torrent, or simply want to keep the torrent file. /exportdata. API DOCS.
This is not supported for cached torrents. You will simply get an error.
Website
Makes it so you cannot pause cached torrents. This is due to abuse from users pausing torrents and them being able to stay on the servers for longer. We previously didn't have any way to combat this, so users were able to keep a torrent paused, but on the download server taking up precious NVME and HDD space. This change was also made on the API side.
Improved SEO as the site has been getting hit by Google a lot recently.
New setting for Stremio Addon allows you to filter Adult content. This filters it from coming up in streams, or in search. This means, for example, if your kid clicks on some Adult content from another catalogue, streams won't show up. Same for search, if a search is supposed to return Adult results, it won't.
Default setting does not show adult content. No config needed. The only reason to change this setting is to show it. You dirty dog. (Not that TorBox has a lot of adult media anyways, but there is some).
New setting for webDAV. You can now flatten your folders, and only show the downloads inside. So if you previously were having to dive into your folders just to find a certain media, then no more!
This also now makes TorBox work with most webDAV clients such as Infuse. Apple TV users rejoice! (I recently purchased one and I love it, which is why this feature is here. On the topic of Infuse, Firecore, the parent company has the worst support and forum ever. Take a look at this discussion on the technical issue of why TorBox wasn't working previously with Infuse. Their team has no idea about anything technical it seems. Anyways...
Stremio Addon
Switched to a new scraping mechanism for torrents! We are now on a event based scraping system (which is what everyone else is doing for some reasons I will explain in a second). This means that as long as it is on a popular tracker, then it will show up. No more waiting for the scraper to find the movie or show you want. Along with this change the metadata engine got an update, giving more rich experiences when using the TorBox Stremio Addon.
To support this new scraping mechanism, the entire system has been redesigned from the ground up. Focusing on accuracy, speed, and reliability, there isn't one addon with more features than TorBox's.
There is a new search API that is open and free to use. You can check it out at https://search-api.torbox.app. It will be getting more updates in the future.
To use it use the /meta/source:id endpoint. To find Fight Club metadata, you would do /meta/imdb:tt0137523.
To find torrents, simply do the same thing with the /torrents/source:id endpoint. You can request metadata here by adding ?metadata=true to the request.
All endpoints are cached so if it has already been searched for, it will return a response in less than 100ms!
I plan to write about the journey for this and all of my recent discoveries creating TorBox here on Substack if you would like to tag along and possibly learn something.
Before, we were using a single Jackett instance for scraping. Now we are using about 10 instances of load balanced Jackett to be able to handle the sheer amount of requests we are getting through the Stremio Addon. Pair that with a rotating proxy, and we have been able to achieve around 5s searching for around 10-15 indexers per request.
Searching is just as fast as ever thanks to Meilisearch.
Metadata is extremely rich thanks to the combination of the IMDB and TMDB APIs for Movies and TV shows as well as the Jikan API for Anime.
Makes compatibility more accessible for other catalogs. For movies and TV shows, it isn't that wide of a range, you can search by IMDB and TMDB ID's. If you want to make your catalog compatible, make sure you add your source ahead of the ID, like imdb:id, or imdb_id:id, or another variation, and TorBox will be able to find it. For anime, it is similar but you can use even more sources such as mal_id:id, mal:id, anilist:id, kitsu:id, kitsu-id:id, kitsu_id:id, and all other anime database sources.
API
Enhanced reliability. Recently, some of our core servers have been going down, and due to the reliance the API has on those servers, it would crash the API making it inaccessible for some time, making it inaccessible to users who need to use the API for other purposes. Now, a downed server will not affect the API, and if you try to use a downed server it will let you know there are connection issues to core servers, and they will be back online soon.
To fight the issue of core servers going down, we are switching providers to one that won't let this happen anymore.
Website:
Downloads with multiple folders now only show the zip button at the root folder, eliminating confusion about which one to click, as they download the entire zip in the first place.
Fixed a bunch of bugs. No more weird error pages. If there is an error, it will now be reported as such and will give you a better error page and tell you what went wrong.
Fixes about stats showing 0.
Service:
Zip files now show a total size, and progress bar. This allows you to see how long a zip has left to download. A big Q.O.L. feature that has been missing for awhile is now back.
Zips files should be more reliable for larger files, as well as get a speed increase.
Fixed webDAV showing 404 on root directory. Now only shows 404 if the file is missing.
Fixes download links not being able to be resumed. (Zip download links are not able to be resumed, but normal file downloads are).
More email domains have been added to the blocklist. If you have an account with those email domains already, you won't be banned, but any new accounts will be.
I know, I know, we just had an update and there are still a lot of bugs! Well, me and a few buddies did a little dev jam and I came up with working on my Discord bot (for TorBox). It took me about 12 hours to get it to this point, and I am pretty happy with it. I will resume with fixing more bugs (yes, I did fix some) now.
Discord Bot
TorBox now has a Discord bot! This is a public bot that can be used anywhere. It's a little limited in functionality, but the main reason for having it around are Discord notifications. But, you can also add torrents on the go as well. This is basically a substitute for the mobile app.
The main reason for using TorBox are the notifications. If you are like me, I always have Discord open, or I get notifications on my phone when I am away from my computer. This helps a lot, especially when most of the alerts for TorBox are done through Discord webhooks.
As long as your account is linked, and you share a server with the TorBox bot, you can get notifications by DM. It will send you a notification instantly, no waiting around for notifications.
If you want to opt out of these notifications, you can disable the setting on the TorBox settings page, by clicking the switch on the Discord Notifications option. You can also just block the bot for awhile if you are lazy like me.
You can also view your torrents, which is cool to share the status of your torrents to others. Show off that ratio baby!
Use the /list command for this.
If the torrent is ready to download, you can also download the torrent, simply by clicking on the name of the torrent.
You can also add new torrents! I am not sure if this has ever been done before, but you can upload files and magnet links (even torrent file links) to the bot, and it will add it to your account!
Use the /add command for this.
Accepts either a magnet link, or torrent file. You cannot do both at the same time.
Works as intended!
Stremio Addon
Fixes streams not showing up. I know right? How could I let that happen. IDK!
Speeds up scraper capabilities.
Loosened restrictions on matching media names, meaning that more torrents will show up. The value is still matched at 85% so if a name 85% matches the torrent name then it will pass. Before, it was at 95%.
The long awaited Stremio addon is available! Along with other changes, v3.6 is focused on the Stremio addon that is officially offered by TorBox. Before, addons such as MediaFusion were available that offered compatibility, but with the new TorBox addon, things are a lot better, smoother, and focused on user experience.
Quick Links:
Stremio Addon Listing (Go Upvote!): https://stremio-addons.netlify.app/torbox
Stremio Addon Manifest (No streaming): https://stremio.torbox.app/manifest.json
Stremio Addon Streaming Manifest: https://stremio.torbox.app/APIKEY/manifest.json
Stremio Addon Help Docs: https://support.torbox.app/hc/torbox-help/articles/1709188474-tor_box-stremio-integration
Website:
Adds Stremio button! Simply click this and it will add the Stremio addon to your app. You must have the app installed for this to work. If you don't have the app installed, you can copy the link that you can use to add to your devices.
Introduces the Integrations Settings section. This section is where you can configure how your integrations work with TorBox.
Adds multiple Stremio settings, that allow you to configure how you can interact with the addon. You can read more about the settings and what they do more in depth here. These settings are instantly updated and next time you try to find streams in the app, your settings will be instantly applied. No more reinstalling addons to change configuration!
Qualities to Show setting. This allows you to customize what qualities you want to show up in the addon.
Resolutions to Show setting. This allows you to customize what resolutions you want to show up in the addon. These are simplified resolutions. Read more in the help docs about what specific resolutions are categorized in each simple resolution.
Languages to Show setting. This allows you to specify what languages you want to show up in the addon. The recommendation is to keep Unknown on as most torrents won't have a language.
Cache Settings. This allows you to set what streams show up, depending on if they are cached or not. If you only want cached streams to show, then click on that setting.
Only show torrents larger than size (in GB). This setting does exactly that, only shows streams larger than a certain size. If you are looking for a specific quality size ratio, you can make this value something like 30.
Only show torrents smaller than size (in GB). Same as the previous setting except that this is the upper limit that a torrent can be. If you only want small torrents, then you keep this value low.
Added the Google Drive integration settings section. This section introduces the folder ID setting which allows you to save your torrent in a specific folder every time. You can read more about the setting here.
Added the OneDrive integration settings section. This section introduces the file path setting which allows you to save your torrent at a specific path every time. You can read more about the setting here.
Fixes OneDrive zipped downloads not being added to OneDrive.
Fixes the Show Main Tracker In Torrent setting not being cloud saved properly.
Subscription page now accurately shows that Perfect Money is now supported for one-time payments.
Updated description for plans.
The Essential Plan is now tailored towards Streaming.
The Standard Plan is now tailored towards Private Torrents
The Pro Plan is now tailored towards Serious Downloaders.
Service:
Moved the API and Stremio Addon API to its own server. This decreased request times by almost 10x. As it was being hosted on a mega server shared with all my other projects, the amount of network requests both API's were getting, they were being blocked by other requests the server was handling. Any issues regarding time outs, or requests not going through, or 502 errors have disappeared. This also fixes the uptime errors we have been running through.
Fixes webDAV long downloads being cancelled halfway through.
Fixes webDAV indexing speeds (going in and out of folders was very slow).
Fixes webDAV 404 error when there is an inactive torrent on the account.
Speeds up cache check requests by almost 2x.
Stremio Addon:
Introduces the Stremio addon! This is available at https://stremio.torbox.app. There are a lot of awesome features to go through, so this list is pretty long.
Configuration is done on the TorBox settings page. This allows for easy configuration that is done all in one place. These settings are also cloud saved meaning that they are instantly applied, with no need to reinstall the addon (ever!).
To add it to Stremio, go the the TorBox settings page and click the Access Stremio Addon.
Torrents
The torrents are what provide TorBox with the files it needs to download to provide you with streams. TorBox scrapes torrents from lots of different trackers (semi-private and public) for the best torrents.
How the torrents are scraped is a little complex, but basically it is just Jackett. Saying that, there is so much more that goes into it. I am planning on writing a blog post about it, along with other discoveries I have made over the years. There are a total of 3 different scrapers. One for Movies, one for Series (TV Shows), and one for Anime (cause I personally wanted a specific one for the best results). The movie and series scraper takes in a list of every single TMDB ID, gets the base metadata, external ID's, alternate titles, and more. It then searches Jackett for each one of the titles, and if it is a TV show, each title with each episode/season number. Once Jackett returns with the data, it cleans the data putting it into the specific order TorBox needs, and then adds it to Meilisearch (the database, which is meant for ultra-fast searches). The same process is done for Anime searches as well.
Torrents include a quality, resolution, size, cache status, and more which allows you to filter properly. If a torrent doesn't have something, it is simply Unknown or 0.
The scraper is run weekly to get the latest torrents. This also assures that new episodes, movies or specials show up in TorBox rather quickly.
Search
Searching for media is done at the top of Stremio, which allows you to quickly and easily search TorBox's scraped torrents. Not every item will have streams depending on the rarity of the media.
Search is full-text meaning you can search for episodes, torrent names, alternate titles and more, and your results will likely show up. Typos included!
Integration with 3rd party catalogues is also very good. You are able to search by the following ID's and your results will show up:
IMDB
TMDB
TVDB
Livechart
Anime Planet
Anisearch
AniDB
Kitsu
MyAnimeList
Anilist
Streaming
Streaming is supported anywhere Stremio is supported. If trying to use Stremio on the web, you are able to open the m3u8 file in an external player, such as VLC and it will play normally.
Low/No buffering! With the power of TorBox's infrastructure, and advanced Cloudflare routing, buffering is no more! (As long as your internet speed is high enough).
Downloading
If a torrent is not cached (does not say Instant) then clicking on the play button will start downloading the torrent to your TorBox account. A video will play stating that the torrent is downloading and you should wait for the download to finish.
If something goes wrong the video will state a generic error.
If you don't have enough slots on your account it will tell you that in the video.
Once the video is done downloading, you will have to play again, then it will begin streaming.
TorBox Media
You can easily view your TorBox media that you have in your account by going to the Discover tab. Select Movies then select Your Media, and your TorBox media will show.
Each item has it's own custom poster so you know exactly what it is and where it came from at a glance.
Future plans
Intros to videos. Sort of like Netflix does, all media streamed through TorBox will play a 3 second intro video. It will add to the professionalism and cool factor of TorBox.
Audio filters. If you audio system cannot play certain audio codecs, this filter is a good idea.
Website
Revamped the subscription page.
Added a section for information about payment methods. This includes information about payment methods, security, and some nice icons showing payment methods at a glance. This is different for each tab.
Added a new a Addons tab. This tab will soon include pricing for the new addon features that users have requested.
Switched from PayPal and Coinbase to Sellix, which is a payment processor that combines PayPal, Crypto, and Card payments all in one, which makes it really easy for users to pay as well as expand TorBox in the future. Basically, nothing has changed, except for adding more crypto payment methods, as well as adding Skrill, and Perfect Money (in the future once TorBox gets approved).
Fixes the open stream button being weirdly short on the download page.
Changes the look of the tabs on the New Torrent Modal, matching the style of the subscription page as well as just looking a lot more sleek.
Website
Added 2FA. Allows you to secure your account by making sure that no one can log in but you.
Only allows using TOTP MFA but more options will be coming eventually. This was a feature that I wanted to get out as soon as possible due to how much access you have to an account on the website.
Only affects logins for the TorBox.app website. You are no required to use 2FA when using the API, WebDAV, FTP, the mobile app, etc.
You can use any 2FA solution, but we recommend Bitwarden. It can be self-hosted too.
No backup codes. This isn't supported by Supabase, but you can contact us to get access back to your account if you somehow lose access to your 2FA.
Added delete confirmations. This makes sure you might not be accidentally deleting things you don't want to delete.
This is a popup that asks you to confirm before deleting.
This happens for every download, but you can choose to ignore this warning for the entire time you are logged in by hitting the switch in the popup.
Fixed Google Drive not working on iOS devices.
Service
Slightly improved download speeds in some situations.
Fixed some downloads not being able to be downloaded if the name has special characters that aren't found in the UTF-8 encoding. It will make sure all download fit in the Latin-1 encoding, meaning it will also work in all browsers. This may mean you will see question marks (?) in place of special characters that cannot be encoded.
The infrastructure update! Oh boy, this one is a doozy, and really should never really should have happened, but in short, we ended up moving to our own infrastructure on our own servers, with our own API's and all new methods for downloads. There were a lot of reasons why we did this, lets start with those first:
Pricing. To keep TorBox affordable and low price as it is, we have to make sure that we are not spending over our margins, and with our previous solution, GoFile.io, that was not possible. Don't get me wrong, GoFile is extremely cheap at $3/tb, and $2/tb in egress, but unfortunately, not cheap enough for TorBox to be able to sustain itself. With the new infrastructure, we can get infinite egress at no charge, and less than $3/tb, which is already a big deal. TorBox users download over 8tb+ a day from our servers, so we have to make sure that we can handle all of that moving data.
Control. Control over your own storage and the flexibility it gives you is very powerful. We decided to move away because we were tied down to their limited API, as well as no control over how files are served in the slightest.
Processing times, and unreliability. To be able to get the files available for download, they had to be transferred to GoFile's servers. This at times could take quite a long time or even straight up fail. This was completely unacceptable, and we dealt with it for awhile, but GoFile never really completely fixed the issue. They did help us out and made some crucial fixes that made it more manageable, but still never got completely fixed. This was one of our user's largest gripes while using GoFile.
Zipped downloads. GoFile promised us a zipped downloads feature, but never actually delivered on that promise. They had it available, in beta, and to only premium users on their site. As zipped downloads are extremely important on the TorBox platform, this left many users and large torrents practically inaccessible.
Integrations. With the GoFile downloads, we could never be able to create the integrations we wanted, such as WebDAV, as it would make it nearly impossible due to their lackluster API.
When GoFile was determined to not be usable anymore, we decided to prop up our own infrastructure and start from scratch. This was not an easy or simple journey, and took all the way up to today, this post to get right. Let me take you through what we tried, and the solution we eventually landed on.
We started by trying out SeaweedFS. This was what we were looking for. A distributed file system, accessible over any machine in the cluster, and had an S3 gateway that allowed us to easily integrate with little effort. This started out great, we got our servers all set up, and got everything going, and at the beginning, things were okay, but didn't really solve all of our problems, and also introduced more. It was definitely cheaper, we had more control, and allowed us to do zipped downloads and integrations, but processing times still were atrocious and unreliable. It also introduced a speed bottleneck. Each server can only handle 1gbit, but the way SeaweedFS is set up, you can't decide where downloads are routed through, so all downloads actually got sent through one heavily speed limited server which was a huge issue and lead to downloads being slow, like 200kbps slow. You can view the issue we made here about our issue.
Then we tried out Ceph. Everyone who has dealt with distributed storage knows Ceph. It is a pain to setup and was the main reason we didn't use it. At this point we knew exactly what we wanted. We wanted Hot+Cold storage, instant transfer from torrents stored on the local system to the storage system, and an easy setup. Ceph only solved one of those issues. So we moved on.
Then we tried out GarageFS. Again, didn't solve our issues. There was no way to transfer data from the local system to the storage system, without going through the network. They also have no way to do Hot+Cold storage.
Then we tried out Minio. Again, didn't solve the local storage issue.
Finally, we tried out Rclone. This solved the issue of local storage issue, as we could use raw files as the storage system thanks to Alias. We were able to make a unified filesystem using all the servers using Union, and serving that over S3, we could route downloads properly. We were also able to implement hot and cold servers based off of remotes and only transferring new torrents to hot servers, all in the background, which also eliminated processing times, and made things really easy to setup over the command line, using a single bash script. We ran into a few issues though:
The S3 gateway was impossible to secure down, meaning that for a period of time you could clone the entire TorBox cache and it was publicly available. This was a huge problem. You can read more about the issue here.
Given the issues we had with hosting S3 over Rclone, we decided to try out something called S3Proxy. The problem here was that presigned requests simply didn't work which is how we gave out download links. There were also issues with authorization not working either, exposing the entire TorBox Cache. You can read more about that issue here.
Downloads were unstable. They would crash half way through, couldn't be resumed, and you could not use Multi-connection downloads like you could before.
So we ended up writing another API specifically for the storage, which basically allows us to solve all of the issues we were facing. The TorBox cache is now completely private, download links are clean and simple to use. Errors are intuitive and have a nice page for users to look at. Downloads can be resumed, you can use up to 16 connections, zips are very easy to use, and no buffering slowdowns either. We did deal with some issues regarding speeds, but for now, they are adequate. We have been making optimizations (thanks to our control over the entire system) and speeds have been climbing. Right now you can expect to hit around 60-70MB/s, but we are trying to get closer to the theoretical maximum which is about 110MB/s. There are so many optimizations we are trying and testing, so I am confident we can get there. Anyways, that is the story of why there have been no updates in forever. We have been dealing with storage, to give our users the best experience possible.
Now onto the actual change log:
Website:
Updated main page speedtest to download the test files.
Available is a 100MB file, 1GB file, and 10GB file. These are in bin format, but are just 0's. The .bin is there so the file can actually be downloaded by our backend.
Updated main page to remove anything about GoFile.io
Adds a pricing button to the header. Eventually we will have a dedicated pricing page for this to lead to.
Adds our infrastructure status link to the footer. This leads to hetrix.torbox.app which is our status page for all of our servers so you can see what each server is doing in real-time.
Adds an announcement panel where general, warnings, errors, and service breaking issues are shown. We added this due to the recent small issues we have been getting on our site, and users contacting us about it, even though we announced it in the Discord server. This solution allows all users, just not members of the Discord to see issues about TorBox.
The different colors give indication how severe the issue is.
Green Border means it is simply an announcement. Things such as discounts, promotions and general announcements will have this border. Easily ignorable.
Yellow Border means it is a warning error. If something is acting flaky, or we are investigating a possible issue, or the issue isn't too big of a deal, it will have this border.
Red Border means there is an error with the site, maybe downloads are down, or a specific part of the site is broken, but won't effect the whole experience, but only some parts of TorBox.
Red Background or a fully red box means that there is a service breaking error, TorBox is down for some reason, or something else that is a very important announcement.
Service:
Switched storage to in house.
Unfortunately this meant that all previous torrents were wiped completely and all user's started fresh. There was a vote in our Discord server over to transfer or wipe the storage, and at a vote of 17-2, it was decided to wipe the storage completely and start from scratch.
This also meant that for about a week, downloads were unreliable, failing, slow, or zips were broken.
For the most part, these issues have been resolved, which is why we are comfortable releasing this as a version.
Downloads are still not as fast as we would like, maxing out in most cases around 30-70MB/s. This is quite far from our goal of 110MB/s as described above. We are constantly making improvements to reach that goal.
Download URLs and zip URLs look a little different now. Downloads are done at ?token=
\\\">storage.torbox.app/dld/<presigned_key>?token=<api_token> and zips are done at ?token=\\\">storage.torbox.app/zip/<presigned_key>?token=<api_token> .Remember to not share your download URLs publicly! They have your API key in them, which is required to download, as well is matched to the presigned token, so only the user which has the presigned token attached to their account can download the torrent. If you share this token, people can access your account, your torrents, and more! Don't let that happen!
Download URLs are still only valid for one hour. This means that you have 1 hour to start the download until it expires. No, it won't cut your download short after that 1 hour, as long as you started it before that 1 hour. If you are downloading the file, then you don't have to worry about it. If you want to pause and come back, make sure you do it within that hour, or else that progress will be gone forever and you will have to restart the download.
Downloads are now multi-connection and resumable. This allows you to download super-fast using up to 16 connections to the server!
This 16 limit is per IP, not per download. If you have 2 downloads using up 8 connections each, you are at your limit. If you try to force 4 downloads using 6 connections each, the last download will never start, and the 3rd one will be limited to 4 connections.
This limit also counts for single downloads. If you try to have more than 16 downloads at a time, the server will block any downloads afterwards until you have under or are at 16 connections.
Zips count for only 1 connections.
Resuming is now possible. Maybe you have a spotty connection, and the download gets paused, you can resume within an hour to continue the download from the progress it was at before.
Zips are not multi-connection. Zips are also not resumable, don't try to pause them, it will fail. These are due to technical reasons, as we zips torrents on the fly.
If you get an error on the download page, it will give you a nice readable error and the error page you know so well.
Fixed Google Drive and OneDrive download errors. These should work fine now.
We know this might not have been the update you were expecting, we were planning on other things too, but our operating expenses were getting too high, and we needed a new solution ASAP. We are resuming adding awesome new features.
NOTE: We are aware of the issue with mismatching file sizes. We are investigating the issue. Keep up to date by joining our Discord server. For now, the issue can be solved by simply waiting for the file to figure itself out. Depending on the size, this could take awhile, which is an issue. We are investigating. Thank you for your patience.
\",\n \"markdown\": \"The infrastructure update! Oh boy, this one is a doozy, and really should never really should have happened, but in short, we ended up moving to our own infrastructure on our own servers, with our own API's and all new methods for downloads. There were a lot of reasons why we did this, lets start with those first:\\n1. **Pricing.** To keep TorBox affordable and low price as it is, we have to make sure that we are not spending over our margins, and with our previous solution, [GoFile.io](http://GoFile.io), that was not possible. Don't get me wrong, GoFile is extremely cheap at $3/tb, and $2/tb in egress, but unfortunately, not cheap enough for TorBox to be able to sustain itself. With the new infrastructure, we can get infinite egress at no charge, and less than $3/tb, which is already a big deal. TorBox users download over 8tb+ a day from our servers, so we have to make sure that we can handle all of that moving data.\\n2. **Control.** Control over your own storage and the flexibility it gives you is very powerful. We decided to move away because we were tied down to their limited API, as well as no control over how files are served in the slightest.\\n3. **Processing times, and unreliability.** To be able to get the files available for download, they had to be transferred to GoFile's servers. This at times could take quite a long time or even straight up fail. This was completely unacceptable, and we dealt with it for awhile, but GoFile never really completely fixed the issue. They did help us out and made some crucial fixes that made it more manageable, but still never got completely fixed. This was one of our user's largest gripes while using GoFile.\\n4. **Zipped downloads.** GoFile promised us a zipped downloads feature, but never actually delivered on that promise. They had it available, in beta, and to only premium users on their site. As zipped downloads are extremely important on the TorBox platform, this left many users and large torrents practically inaccessible.\\n5. **Integrations.** With the GoFile downloads, we could never be able to create the integrations we wanted, such as WebDAV, as it would make it nearly impossible due to their lackluster API.\\n\\nWhen GoFile was determined to not be usable anymore, we decided to prop up our own infrastructure and start from scratch. This was not an easy or simple journey, and took all the way up to today, this post to get right. Let me take you through what we tried, and the solution we eventually landed on.\\n1. We started by trying out [SeaweedFS](https://github.com/seaweedfs/seaweedfs). This was what we were looking for. A distributed file system, accessible over any machine in the cluster, and had an S3 gateway that allowed us to easily integrate with little effort. This started out great, we got our servers all set up, and got everything going, and at the beginning, things were okay, but didn't really solve all of our problems, and also introduced more. It was definitely cheaper, we had more control, and allowed us to do zipped downloads and integrations, but processing times still were atrocious and unreliable. It also introduced a speed bottleneck. Each server can only handle 1gbit, but the way SeaweedFS is set up, you can't decide where downloads are routed through, so all downloads actually got sent through one heavily speed limited server which was a huge issue and lead to downloads being slow, like 200kbps slow. You can view the issue we made [here](https://github.com/seaweedfs/seaweedfs/issues/5266) about our issue.\\n2. Then we tried out Ceph. Everyone who has dealt with distributed storage knows Ceph. It is a pain to setup and was the main reason we didn't use it. At this point we knew exactly what we wanted. We wanted Hot+Cold storage, instant transfer from torrents stored on the local system to the storage system, and an easy setup. Ceph only solved one of those issues. So we moved on.\\n3. Then we tried out GarageFS. Again, didn't solve our issues. There was no way to transfer data from the local system to the storage system, without going through the network. They also have no way to do Hot+Cold storage.\\n4. Then we tried out Minio. Again, didn't solve the local storage issue.\\n5. Finally, we tried out Rclone. This solved the issue of local storage issue, as we could use raw files as the storage system thanks to Alias. We were able to make a unified filesystem using all the servers using Union, and serving that over S3, we could route downloads properly. We were also able to implement hot and cold servers based off of remotes and only transferring new torrents to hot servers, all in the background, which also eliminated processing times, and made things really easy to setup over the command line, using a [single bash script](https://gist.github.com/Wamy-Dev/4f10e107d812f13813a20fc7de2ce24a). We ran into a few issues though:\\n 1. The S3 gateway was impossible to secure down, meaning that for a period of time you could clone the entire TorBox cache and it was publicly available. This was a huge problem. You can read more about [the issue here](https://github.com/rclone/rclone/issues/7616).\\n 2. Given the issues we had with hosting S3 over Rclone, we decided to try out something called S3Proxy. The problem here was that presigned requests simply didn't work which is how we gave out download links. There were also issues with authorization not working either, exposing the entire TorBox Cache. You can read more about [that issue here](https://github.com/gaul/s3proxy/issues/581).\\n 3. Downloads were unstable. They would crash half way through, couldn't be resumed, and you could not use Multi-connection downloads like you could before.\\n \\n\\nSo we ended up writing another API specifically for the storage, which basically allows us to solve all of the issues we were facing. The TorBox cache is now completely private, download links are clean and simple to use. Errors are intuitive and have a nice page for users to look at. Downloads can be resumed, you can use up to 16 connections, zips are very easy to use, and no buffering slowdowns either. We did deal with some issues regarding speeds, but for now, they are adequate. We have been making optimizations (thanks to our control over the entire system) and speeds have been climbing. Right now you can expect to hit around 60-70MB/s, but we are trying to get closer to the theoretical maximum which is about 110MB/s. There are so many optimizations we are trying and testing, so I am confident we can get there. Anyways, that is the story of why there have been no updates in forever. We have been dealing with storage, to give our users the best experience possible.\\n*Now onto the actual change log:*\\n### **Website:**\\n- Updated main page speedtest to download the test files.\\n - Available is a 100MB file, 1GB file, and 10GB file. These are in bin format, but are just 0's. The .bin is there so the file can actually be downloaded by our backend.\\n \\n- Updated main page to remove anything about [GoFile.io](http://GoFile.io)\\n- Adds a pricing button to the header. Eventually we will have a dedicated pricing page for this to lead to.\\n- Adds our infrastructure status link to the footer. This leads to [hetrix.torbox.app](http://hetrix.torbox.app) which is our status page for all of our servers so you can see what each server is doing in real-time.\\n- Adds an announcement panel where general, warnings, errors, and service breaking issues are shown. We added this due to the recent small issues we have been getting on our site, and users contacting us about it, even though we announced it in the Discord server. This solution allows all users, just not members of the Discord to see issues about TorBox.\\n - The different colors give indication how severe the issue is.\\n - Green Border means it is simply an announcement. Things such as discounts, promotions and general announcements will have this border. Easily ignorable.\\n - Yellow Border means it is a warning error. If something is acting flaky, or we are investigating a possible issue, or the issue isn't too big of a deal, it will have this border.\\n - Red Border means there is an error with the site, maybe downloads are down, or a specific part of the site is broken, but won't effect the whole experience, but only some parts of TorBox.\\n - Red Background or a fully red box means that there is a service breaking error, TorBox is down for some reason, or something else that is a very important announcement.\\n \\n \\n\\n### **Service:**\\n- Switched storage to in house.\\n - Unfortunately this meant that all previous torrents were wiped completely and all user's started fresh. There was a vote in our Discord server over to transfer or wipe the storage, and at a vote of 17-2, it was decided to wipe the storage completely and start from scratch.\\n - This also meant that for about a week, downloads were unreliable, failing, slow, or zips were broken.\\n - For the most part, these issues have been resolved, which is why we are comfortable releasing this as a version.\\n - Downloads are still not as fast as we would like, maxing out in most cases around 30-70MB/s. This is quite far from our goal of 110MB/s as described above. We are constantly making improvements to reach that goal.\\n \\n - Download URLs and zip URLs look a little different now. Downloads are done at [storage.torbox.app/dld/Website
Fixed tons of bugs from launch of v3.4.
Fixed large zip files from being processed. This was due to our MD5 hashing running out of memory for large files as we were not doing it in chunks as we were supposed to.
Fixed zip files from being located at /downloads/zipfile.zip rather than /hash/zipfile.zip, which lead to some zip files with the same names being overwritten.
Disallows trying to watch .mkv files in the browser, because it simply will just not work.
In the settings tab, adds a section for Clients, where the mobile app buttons have been moved. This also has a link for Webdav as well as upcoming clients such as FTP, Stremio, Discord bot integrations.
Adds loading indicator for requesting zip links.
Service
Moved zipping to separate API as it was causing problems being in the same container as the main API. Then new endpoint is https://storage-zip.torbox.app.
Old requests to the normal API will be forwarded properly to the storage-zip API.
Added Webdav! You can access it at https://webdav.torbox.app. This works for both any webdav client or even your browser.
The website is absolutely beautiful and works very well. Would recommend this if on a desktop. 100% guaranteed it is the best webdav interface you have ever seen. Makes you feel more at home with TorBox.
Easily log in using your email and password, the same one you use for TorBox!
Requires you to have a password set up on your account. If you don't have one yet, go to https://torbox.app/settings to send a password recovery email.
Downloads are a little slow, just like all other downloads on the site right now. This is a work in progress and we are getting more servers soon which will speed things up.
Access this on all different platforms such as Kodi, Infuse and more!
This does not work for older GoFile files, so it will not show those torrents.
Due to the way we internally organize torrents, the hash of the torrent has to be shown on the root path. We are looking to eventually only show the name of the torrent, but this is good enough for now.
Older zip files, created after this update will not show up in the webdav.
For some reason Infuse doesn't recognize the webdav. I honestly have no idea why. It works fine when mounting on any other device, with Rclone, on the browser, just not Infuse. I have contacted the developers for help on the issue.
The logout button doesn't work for some reason. If you really want to log out, well, you can't. Just come back in a few hours and you should be logged out.
Oh yeah, did I mention that Rclone is now usable with TorBox? With webdav it is! Check out this guide on how to do it.
In depth server statistics can be viewed at our new Hetrix dashboard!
You can view this data all at https://hetrix.torbox.app.
This in depth data allows you to view everything about the servers TorBox uses. Status, Ram, Disk, CPU, and more can all be found here. This was mainly an effort to be as open as we can with our customers, this in part, allows customers to see where their money is going.
Mobile
New version of app supports cached downloads. Instead of cached downloads showing as inactive, they will be shown as cached and allowed to be downloaded.
NOTE: We are aware of the slow processing speeds, as well as the slow downloads. We are scaling quickly to fix these issues, which literally just requires us to throw more money at the problem to be fixed. It is simply an issue of too many users, not enough servers. We promise, things will get better soon.
\",\n \"markdown\": \"### **Website**\\n- Fixed tons of bugs from launch of v3.4.\\n- Fixed large zip files from being processed. This was due to our MD5 hashing running out of memory for large files as we were not doing it in chunks as we were supposed to.\\n- Fixed zip files from being located at */downloads/*[*zipfile.zip*](http://zipfile.zip) rather than */hash/*[*zipfile.zip*](http://zipfile.zip), which lead to some zip files with the same names being overwritten.\\n- Disallows trying to watch .mkv files in the browser, because it simply will just not work.\\n- In the settings tab, adds a section for Clients, where the mobile app buttons have been moved. This also has a link for Webdav as well as upcoming clients such as FTP, Stremio, Discord bot integrations.\\n- Adds loading indicator for requesting zip links.\\n\\n### **Service**\\n- Moved zipping to separate API as it was causing problems being in the same container as the main API. Then new endpoint is [https://storage-zip.torbox.app](https://storage-zip.torbox.app).\\n - Old requests to the normal API will be forwarded properly to the storage-zip API.\\n \\n- **Added Webdav**! You can access it at [https://webdav.torbox.app](https://webdav.torbox.app). This works for both any webdav client or even your browser.\\n - The website is absolutely beautiful and works very well. Would recommend this if on a desktop. 100% guaranteed it is the best webdav interface you have ever seen. Makes you feel more at home with TorBox.\\n - Easily log in using your email and password, the same one you use for TorBox!\\n - Requires you to have a password set up on your account. If you don't have one yet, go to [https://torbox.app/settings](https://torbox.app/settings) to send a password recovery email.\\n - Downloads are a little slow, just like all other downloads on the site right now. This is a work in progress and we are getting more servers soon which will speed things up.\\n - Access this on all different platforms such as Kodi, Infuse and more!\\n - This does not work for older GoFile files, so it will not show those torrents.\\n - Due to the way we internally organize torrents, the hash of the torrent has to be shown on the root path. We are looking to eventually only show the name of the torrent, but this is good enough for now.\\n - Older zip files, created after this update will not show up in the webdav.\\n - For some reason Infuse doesn't recognize the webdav. I honestly have no idea why. It works fine when mounting on any other device, with Rclone, on the browser, just not Infuse. I have contacted the developers for help on the issue.\\n - The logout button doesn't work for some reason. If you really want to log out, well, you can't. Just come back in a few hours and you should be logged out.\\n - Oh yeah, did I mention that Rclone is now usable with TorBox? With webdav it is! Check out [this](https://rclone.org/webdav/) guide on how to do it.\\n \\n- In depth server statistics can be viewed at our new Hetrix dashboard!\\n - You can view this data all at [https://hetrix.torbox.app](https://hetrix.torbox.app).\\n - This in depth data allows you to view everything about the servers TorBox uses. Status, Ram, Disk, CPU, and more can all be found here. This was mainly an effort to be as open as we can with our customers, this in part, allows customers to see where their money is going.\\n \\n\\n### **Mobile**\\n- New version of app supports cached downloads. Instead of cached downloads showing as *inactive*, they will be shown as cached and allowed to be downloaded.\\n\\n*NOTE: We are aware of the slow processing speeds, as well as the slow downloads. We are scaling quickly to fix these issues, which literally just requires us to throw more money at the problem to be fixed. It is simply an issue of too many users, not enough servers. We promise, things will get better soon.*\\n\",\n \"link\": \"https://feedback.torbox.app/changelog/new-changelog-358\",\n \"created_at\": \"2024-01-25T22:14:28Z\",\n \"id\": \"65af369c8a898e7dd25e8332\"\n },\n {\n \"name\": \"v3.4\",\n \"html\": \"A much needed update which fixes a lot of issues, and solves pricing problems for TorBox. This means that better features, more servers, faster servers and more discounts are on the way! This is a much needed step for our infrastructure with the boom in Stremio and Kodi users coming in. You can now use addons such as MediaFusion to instantly watch movies using TorBox on Stremio. We are also developing our own addon with the most content ever seen for a Stremio addon, which will top even Torrentio (which does not even support TorBox yet). With cached downloads becoming more of a necessity, we decided to move ahead with this. Please enjoy!
PS. You can now comment on these changelogs, so tell us what you think!
Website
Moves new storage to self hosted storage in Luxembourg.
Old GoFile downloads will still work until they expire. These torrents are not cached, and will not be migrated. The last GoFile link will stop working 1 month from now, on February 19, but you likely won't even notice. (This hasn't been extensively tested as we have no way to do so on our testing servers, so for the first few hours, we will be monitoring the situation).
Brings back zipped downloads. When we moved to GoFile.io we were not able to support zipped files from there. Now that we have moved to self hosting, we are able to support zipped downloads.
Downloads are only available for 1 hour just like normal downloads. As long as you start the download within the hour time limit, you won't even notice a problem.
Zipped downloads are not multi-connection, and don't tell you how long they have left to download. This will be fixed eventually as we dial in our zipping in a little bit better.
Zipped downloads also have a speed decrease of about 10% from our benchmarks as they are zipped on the fly, and are not pre-made (to save space and money).
Cached downloads are now available forever (basically), and only get deleted if not downloaded for more than 30 days. So if you create a torrent, and it stops seeding after 24 hours, it will still be cached and available for you to download. You can even remove a torrent from your dashboard, and re-add it a few days later, and it will instantly be available for you to download.
This means that in most cases popular torrents will already be available to download.
Cached downloads do not count as active downloads for anyone but free users. That means that if a torrent is already cached, then you won't have to wait, and it won't cost you a download spot. Active downloads now mean only downloads that are actively downloading or seeding from peers. Theoretically, if all you use are cached downloads, you can have infinite torrents available to you.
This also means that any torrents that may be over your limit are allowed to you now if they are cached. If a Pro user already downloaded a 300gb torrent, and you also download it as a Essential user, you also have access to it. This also applies to free users. It costs us nothing to let you download already downloaded torrents so enjoy the feature :)
We hope that eventually we will have a larger cache than even Real-Debrid. We are actively working on caching the most popular torrents, so most things will be ready for you already.
OneDrive and Google Drive work a little bit better now. It seems like sometimes Google blocks the server's requests due to location, so that may be an issue to tackle in the next update.
Made the site more responsive. When you pause a torrent, it will instantly be paused. Same with resuming. When you click on the download button it will now show a loading icon, while it is retrieving your download link, which leads to a better user experience. Some users were complaining about the perceived speed of the site, so this was a needed change.
The quick stats only show up when you have downloads in a category that it pertains to. So if you only have active downloads, that's all that will show up. If you don't have any inactive downloads, that's all that will show up.
Removes notifications when you pause, resume, or delete a torrent. It just does as you say. The notifications felt redundant.
Adds owner to torrent.
What this means is that if you download a cached torrent that someone is currently downloading (either in progress, or is processing), then you are not allowed to control that torrent. This only basically means that you cannot pause or resume the torrent.
Basically no bug fixes!
API (has breaking changes)
We tried our best to avoid breaking changes, but here they are. We hope it's not too inconvenient.
Requesting download structure has changed a little bit. You no longer have to give a folder_id, but are required to specify a boolean for the new param, zip_link. This allows you to get the direct link for a zipped download for the entire torrent. You can read more about it on the docs page. API DOCS.
The examples for these changes have not been updated yet, but the requests have been.
Requesting zips are no longer used, as it is mostly internal as you now need a presigned_token that you can't generate yourself. This has mostly been replaced by the request download endpoint, as the request zip endpoint now serves the download rather than return a link. API DOCS.
The examples for these changes have not been updated yet, but the requests have been.
If you want to download the zip of a torrent, simply use the request download endpoint.
Google Drive and OneDrive endpoints no longer require the folder_id parameter and instead take the zip parameter, which is a boolean stating if you want it zipped or not.
NOTE: Downloads will likely be (sort of) slow for the first few weeks as we build up cache and begin adding more servers. Once files have been migrated around and the load has gotten a little lighter on the first few servers, things will be a lot faster. Hopefully you never even notice it.
\",\n \"markdown\": \"A much needed update which fixes a lot of issues, and solves pricing problems for TorBox. This means that better features, more servers, faster servers and more discounts are on the way! This is a much needed step for our infrastructure with the boom in Stremio and Kodi users coming in. You can now use addons such as [MediaFusion](https://882b9915d0fe-mediafusion.baby-beamup.club/) to instantly watch movies using TorBox on Stremio. We are also developing our own addon with the most content ever seen for a Stremio addon, which will top even Torrentio (which does not even support TorBox yet). With cached downloads becoming more of a necessity, we decided to move ahead with this. Please enjoy!\\n*PS. You can now comment on these changelogs, so tell us what you think!*\\n### **Website**\\n- Moves new storage to self hosted storage in Luxembourg.\\n - Old GoFile downloads will still work until they expire. These torrents are not cached, and will not be migrated. The last GoFile link will stop working 1 month from now, on February 19, but you likely won't even notice. *(This hasn't been extensively tested as we have no way to do so on our testing servers, so for the first few hours, we will be monitoring the situation)*.\\n \\n- Brings back zipped downloads. When we moved to [GoFile.io](http://GoFile.io) we were not able to support zipped files from there. Now that we have moved to self hosting, we are able to support zipped downloads.\\n - Downloads are only available for 1 hour just like normal downloads. *As long as you start the download within the hour time limit, you won't even notice a problem.*\\n - **Zipped downloads are not multi-connection, and don't tell you how long they have left to download. **This will be fixed eventually as we dial in our zipping in a little bit better.\\n - Zipped downloads also have a speed decrease of about 10% from our benchmarks as they are zipped on the fly, and are not pre-made (to save space and money).\\n \\n- Cached downloads are now available forever (basically), and only get deleted if not downloaded for more than 30 days. So if you create a torrent, and it stops seeding after 24 hours, it will still be cached and available for you to download. You can even remove a torrent from your dashboard, and re-add it a few days later, and it will instantly be available for you to download.\\n - This means that in most cases popular torrents will already be available to download.\\n - **Cached downloads do not count as active downloads for anyone but free users**. That means that if a torrent is already cached, then you won't have to wait, and it won't cost you a download spot. Active downloads now mean only downloads that are actively downloading or seeding from peers. Theoretically, if all you use are cached downloads, you can have infinite torrents available to you.\\n - This also means that any torrents that may be over your limit are allowed to you now if they are cached. If a Pro user already downloaded a 300gb torrent, and you also download it as a Essential user, you also have access to it. This also applies to free users. It costs us nothing to let you download already downloaded torrents so enjoy the feature :)\\n \\n - We hope that eventually we will have a larger cache than even Real-Debrid. We are actively working on caching the most popular torrents, so most things will be ready for you already.\\n \\n- OneDrive and Google Drive work a little bit better now. It seems like sometimes Google blocks the server's requests due to location, so that may be an issue to tackle in the next update.\\n- Made the site more responsive. When you pause a torrent, it will instantly be paused. Same with resuming. When you click on the download button it will now show a loading icon, while it is retrieving your download link, which leads to a better user experience. Some users were complaining about the perceived speed of the site, so this was a needed change.\\n- The quick stats only show up when you have downloads in a category that it pertains to. So if you only have active downloads, that's all that will show up. If you don't have any inactive downloads, that's all that will show up.\\n- Removes notifications when you pause, resume, or delete a torrent. It just does as you say. The notifications felt redundant.\\n- Adds owner to torrent.\\n - What this means is that if you download a cached torrent that someone is currently downloading (either in progress, or is processing), then you are not allowed to control that torrent. This only basically means that you cannot pause or resume the torrent.\\n \\n- Basically no bug fixes!\\n\\n### **API *(has breaking changes)***\\n- **We tried our best to avoid breaking changes, but here they are. We hope it's not too inconvenient. **\\n- Requesting download structure has changed a little bit. You no longer have to give a ***folder\\\\_id***, but are required to specify a boolean for the new param, ***zip\\\\_link***. This allows you to get the direct link for a zipped download for the entire torrent. You can read more about it on the docs page. [API DOCS](https://documenter.getpostman.com/view/29572726/2s9YXo1zX4#cc4ceac8-7cb6-4be5-bf09-f949d9e9a458).\\n - The examples for these changes have not been updated yet, but the requests have been.\\n \\n- Requesting zips are no longer used, as it is mostly internal as you now need a **presigned\\\\_token** that you can't generate yourself. This has mostly been replaced by the request download endpoint, as the request zip endpoint now serves the download rather than return a link. [API DOCS](https://documenter.getpostman.com/view/29572726/2s9YXo1zX4#d225fed0-6502-4bd3-8c6a-70cf802f0088).\\n - The examples for these changes have not been updated yet, but the requests have been.\\n - If you want to download the zip of a torrent, simply use the request download endpoint.\\n \\n- Google Drive and OneDrive endpoints no longer require the ***folder\\\\_id*** parameter and instead take the ***zip*** parameter, which is a boolean stating if you want it zipped or not.\\n\\n*NOTE: Downloads will likely be (sort of) slow for the first few weeks as we build up cache and begin adding more servers. Once files have been migrated around and the load has gotten a little lighter on the first few servers, things will be a lot faster. Hopefully you never even notice it.*\\n\",\n \"link\": \"https://feedback.torbox.app/changelog/v34\",\n \"created_at\": \"2024-01-20T02:18:31Z\",\n \"id\": \"65a6094acbfec0a42d6a6f49\"\n },\n {\n \"name\": \"v3.3.1\",\n \"html\": \"Website
Adds torrent search feature (in a minor release???). This allows you to easily search for torrents right inside TorBox. This also allows you to easily add the torrents to TorBox just by clicking on it. No more needing to go to sketchy torrent websites. Simply search on TorBox.
Disables the Stream in Player button for downloads that aren't compatible. Now it only works on video and audio.
Made user creation more reliable. Before, API keys might not be created for a user, rendering their experience inaccessible.
Moves quick stats to the top of the dashboard, rather than being out of place on the right side.
Fixes large notifications overflowing the notifications panel.
API
Adds caching to data heavy routes. This will speed up requests and reduce load on the server. Caching is only for 1 hour.
Adds route for adding queries to the queue for the scraper to search for. You can read more about the process and the need for this here. API DOCS LINK.
/torrents/storesearchAdds route for searching for torrents. The website uses the Meilisearch SDK, so this is only used for the API and developers to reduce the need for an API key, which is not required. You can read more about searching here. API DOCS LINK.
/torrents/search
Introducing the Streaming update! This was a much needed feature that was missing up until now! You can now easily stream your videos and your music/audio. This used to be a feature but was removed in v2. It is now back, along with other good modifications that people have been asking for!
Website
Allows streaming of video and audio. Simply click the Video Button or the Audio Button. It will take you to the
/streampage. Here, simply click the play button and your stream will begin after some time.![](\\\"https://fb-usercontent.fra1.cdn.digitaloceanspaces.com/1703980784175.png\\\")
![](\\\"https://fb-usercontent.fra1.cdn.digitaloceanspaces.com/1703980831150.png\\\")
Enjoy zero buffering thanks to GoFile.io!
Allows creating a high quality stream. This stream allows you to get multiple bitrates such as 480p, 720p, 1080p, and even 4k (HDR is supported). If your video is a video type that cannot be played in the browser, this also allows you to play that video. This allows you to also switch audio tracks, as well as showing subtitles and switching subtitle languages.
It has a slight catch though so beware. If the video has never been watched before, it will have to go through a transcoding process which can take some time. For 30 minutes of video, it takes about 7-8 minutes for the process to be complete.
Because it can take awhile, you will receive a notification once it is finished, or if you stay on the streaming page, your page will automatically update once the process is complete.
This feature is only for testing at the moment while we figure out caching, and storage for said items. It is also considerably expensive for TorBox, as we have to save multiple versions of the video. Transcoding is also a time consuming and expensive(ish) process. It just needs more time to get right.
Allows getting direct streaming links for popular 3rd party apps such as VLC, Stremio, and Infuse. Also allows you to directly copy the streaming link.
These links only work if you have the apps downloaded on your PC or Mobile device. We will have a guide for users on how to add these to their devices.
Fixed the torrent menu popup border being cut off on the edges when having more than 3 torrents.
Allows viewing the main tracker that the torrent is downloading from. You have to enable this in the settings under Show Main Tracker In Torrent.
Fixed being able to click reannounce, pause/resume, buttons when a torrent is inactive.
Shows some stats when a torrent is inactive. It now shows created at date, expired at date, ending ratio, total seeded and the size of the torrent. Go show off those torrents!
Adds footer to Download page, RSS Feed page, Streaming page, and Settings page.
Adds Add To Download Manager button on mobile devices.
Bans new users using the \\\"period\\\" trick when using Gmail emails. Previously users were able to create accounts using emails such as \\\"t.o.r.b.o.x@gmail.com\\\", and \\\"t.orbox@gmail.com\\\" and \\\"t.o.rbox@gmail.com\\\", etc. This allowed you to create 3 accounts from only one email, which is considered abuse of the system. No accounts have been banned which used this trick previously, but any accounts signing up trying to use this trick will be banned instantly.
Now, this is not to say you can't use it, if this is the first time you are using that email, then it works fine, and you won't be banned. But if you try and use multiple of the same email, the API will see that and ban any accounts afterwards.
This also applies to the \\\"+\\\" trick. If you have an account with \\\"hello+torbox@gmail.com\\\" and now you are signing up with \\\"hel.lo@gmail.com\\\", \\\"hel.lo@gmail.com\\\" will be banned. Works the other way around too.
Torrent status are more descriptive, such as telling you where there are no seeds, or no peers to download from.
Referrals are now copied as links that you can easily share with friends or family.
Whenever a user is logged in and they click on the link, they will automatically be asked to add this referral code on top of their current one. This way they won't forget about it.
Users are only asked once per session. If they for some reason deny, then they won't be asked again until they open a new browser session (Closing and opening again).
This makes referrals more simple, and less of a hassle. It was also requested by a user in the Discord server.
Fixed issue with some long magnets not being added due to random error. This also fixed magnets with no name or no trackers.
Added backup domains (seemed fun to do and they were crazy cheap on Porkbun, so I had to cop. There is no danger for TorBox, but it is possible that other countries can block the main site.):
Changes site Discord links to https://discord.torbox.app, in case the main link ever changes.
Changed how emails look. Instead of just getting a text email, you now get fancy emails!
API
Added route to get Torrent Instant Cached Availability. This was added for developers mostly who wanted a Real-Debrid like API. Simply input a hash, and it will return a True/False boolean telling you if it is cached or not. You will have to start the download yourself though. API DOCS LINK.
/torrents/checkcachedAdded route to use Referral code added to a user's account using the API. This can be an incentive for developers to use make this call automatically, maybe when a user uses their app, or when they link their account, the developer can make this call and have the user use the developer's referral code. Note: This only adds the code if the user does not already have one. Referral codes cannot be forcibly replaced using the API due to possible abuse by the developers. Codes can be manually changed on the website at the bottom of https://torbox.app/subscription. Requires a user's API key. API DOCS LINK.
/user/addreferralThe create torrent endpoint (
/torrents/createtorrent)now gives torrent_id, hash, and name when a torrent has been successfully submitted. API DOCS LINK.
Mobile App
Adds Register and Get Password links to login page for easy access for new users.
Fixes layout of dashboard as the Account and Sign Out buttons were overflowing on the screen.
For logged in users, when you first open up the app, the app no longer shows the Login screen for a split second.
Fixes long magnet links taking up the entire screen.
Fixes magnet links not being submitted properly to API.
NOTE: The main player does not support subtitles or multiple audio streams. For that, please use an 3rd party player such as Stremio, VLC, or Infuse. This will be fixed eventually when we get streaming properly working and out of testing.
v3.4 will be all 'bout caching and storage. Basically making TorBox faster and more efficient.
v3.5 will be all about better authentication. Adding Multifactor as well as other ways of logging such as on TVs for future apps 👀.
\",\n \"markdown\": \"Introducing the Streaming update! This was a much needed feature that was missing up until now! You can now easily stream your videos and your music/audio. This used to be a feature but was removed in v2. It is now back, along with other good modifications that people have been asking for!\\n### **Website**\\n- Allows streaming of video and audio. Simply click the *Video Button *or the* Audio Button*. It will take you to the `/stream` page. Here, simply click the play button and your stream will begin after some time.\\n - Enjoy zero buffering thanks to [GoFile.io](http://GoFile.io)!\\n \\n- Allows creating a high quality stream. This stream allows you to get multiple bitrates such as 480p, 720p, 1080p, and even 4k (HDR is supported). If your video is a video type that cannot be played in the browser, this also allows you to play that video. This allows you to also switch audio tracks, as well as showing subtitles and switching subtitle languages.\\n - It has a slight catch though so beware. If the video has never been watched before, it will have to go through a transcoding process which can take some time. For 30 minutes of video, it takes about 7-8 minutes for the process to be complete.\\n - Because it can take awhile, you will receive a notification once it is finished, or if you stay on the streaming page, your page will automatically update once the process is complete.\\n \\n - This feature is only for testing at the moment while we figure out caching, and storage for said items. It is also considerably expensive for TorBox, as we have to save multiple versions of the video. Transcoding is also a time consuming and expensive(ish) process. It just needs more time to get right.\\n \\n- Allows getting direct streaming links for popular 3rd party apps such as VLC, Stremio, and Infuse. Also allows you to directly copy the streaming link.\\n - These links only work if you have the apps downloaded on your PC or Mobile device. We will have a guide for users on how to add these to their devices.\\n \\n- Fixed the torrent menu popup border being cut off on the edges when having more than 3 torrents.\\n- Allows viewing the main tracker that the torrent is downloading from. You have to enable this in the settings under **Show Main Tracker In Torrent**.\\n- Fixed being able to click *reannounce*, *pause/resume*, buttons when a torrent is inactive.\\n- Shows some stats when a torrent is inactive. It now shows *created at date*, *expired at date*, *ending ratio*, *total seeded* and the *size* of the torrent. Go show off those torrents!\\n- Adds footer to *Download page*, *RSS Feed page*, *Streaming page*, and *Settings page*.\\n- Adds *Add To Download Manager* button on mobile devices.\\n- Bans new users using the \\\"period\\\" trick when using Gmail emails. Previously users were able to create accounts using emails such as \\\"[t.o.r.b.o.x@gmail.com](mailto:t.o.r.b.o.x@gmail.com)\\\", and \\\"[t.orbox@gmail.com](mailto:t.orbox@gmail.com)\\\" and \\\"[t.o.rbox@gmail.com](mailto:t.o.rbox@gmail.com)\\\", etc. This allowed you to create 3 accounts from only one email, which is considered abuse of the system. No accounts have been banned which used this trick previously, but any accounts signing up trying to use this trick will be banned instantly.\\n - Now, this is not to say you can't use it, if this is the first time you are using that email, then it works fine, and you won't be banned. But if you try and use multiple of the same email, the API will see that and ban any accounts afterwards.\\n - This also applies to the \\\"+\\\" trick. If you have an account with \\\"[hello+torbox@gmail.com](mailto:hello+torbox@gmail.com)\\\" and now you are signing up with \\\"[hel.lo@gmail.com](mailto:hel.lo@gmail.com)\\\", \\\"[hel.lo@gmail.com](mailto:hel.lo@gmail.com)\\\" will be banned. Works the other way around too.\\n \\n- Torrent status are more descriptive, such as telling you where there are no seeds, or no peers to download from.\\n- Referrals are now copied as links that you can easily share with friends or family.\\n - Whenever a user is logged in and they click on the link, they will automatically be asked to add this referral code on top of their current one. This way they won't forget about it.\\n - Users are only asked once per session. If they for some reason deny, then they won't be asked again until they open a new browser session (Closing and opening again).\\n - This makes referrals more simple, and less of a hassle. It was also requested by a user in the [Discord server](https://discord.torbox.app).\\n \\n- Fixed issue with some long magnets not being added due to random error. This also fixed magnets with no name or no trackers.\\n- Added backup domains (seemed fun to do and they were crazy cheap on Porkbun, so I had to cop. There is no danger for TorBox, but it is possible that other countries can block the main site.):\\n - [https://torbox.pro](https://torbox.pro)\\n - [https://torbox.online](https://torbox.online)\\n - [https://torbox.cloud](https://torbox.cloud)\\n - [https://bakabox.app](https://bakabox.app)\\n \\n- Changes site Discord links to [https://discord.torbox.app](https://discord.torbox.app), in case the main link ever changes.\\n- Changed how emails look. Instead of just getting a text email, you now get fancy emails!\\n\\n### **API**\\n- Added route to get Torrent Instant Cached Availability. This was added for developers mostly who wanted a Real-Debrid like API. Simply input a hash, and it will return a True/False boolean telling you if it is cached or not. You will have to start the download yourself though. [API DOCS LINK](https://documenter.getpostman.com/view/29572726/2s9YXo1zX4#99e1b7a7-bdf6-4884-af9d-bd9903a8ca63). `/torrents/checkcached`\\n- Added route to use Referral code added to a user's account using the API. This can be an incentive for developers to use make this call automatically, maybe when a user uses their app, or when they link their account, the developer can make this call and have the user use the developer's referral code. Note: This only adds the code if the user does not already have one. Referral codes cannot be forcibly replaced using the API due to possible abuse by the developers. Codes can be manually changed on the website at the bottom of [https://torbox.app/subscription](https://torbox.app/subscription). Requires a user's API key. [API DOCS LINK](https://documenter.getpostman.com/view/29572726/2s9YXo1zX4#703cd861-908a-4021-b682-9414f581c9fa). `/user/addreferral`\\n- The create torrent endpoint (`/torrents/createtorrent)` now gives *torrent\\\\_id*, *hash*, and *name* when a torrent has been successfully submitted. [API DOCS LINK](https://documenter.getpostman.com/view/29572726/2s9YXo1zX4#062b717f-4866-4fc0-a3e6-6e4c2520eefa).\\n\\n### **Mobile App**\\n- Adds *Register* and *Get Password* links to login page for easy access for new users.\\n- Fixes layout of dashboard as the *Account* and *Sign Out* buttons were overflowing on the screen.\\n- For logged in users, when you first open up the app, the app no longer shows the *Login* screen for a split second.\\n- Fixes long magnet links taking up the entire screen.\\n- Fixes magnet links not being submitted properly to API.\\n\\n*NOTE: The main player does not support subtitles or multiple audio streams. For that, please use an 3rd party player such as Stremio, VLC, or Infuse. This will be fixed eventually when we get streaming properly working and out of testing.*\\n*v3.4 will be all 'bout caching and storage. Basically making TorBox faster and more efficient.*\\nv3.5 will be all about better authentication. Adding Multifactor as well as other ways of logging such as on TVs for future apps 👀.\\n\",\n \"link\": \"https://feedback.torbox.app/changelog/v33\",\n \"created_at\": \"2024-01-08T06:00:00Z\",\n \"id\": \"6590ad640be3e19e94395309\"\n },\n {\n \"name\": \"v3.2\",\n \"html\": \"Website
Added pagination to notifications. If you have more than 5 notifications, you can now view them all using pagination.
Fixed notification popup acting weird at some points.
Allows processing downloads to get updates rather than looking frozen.
Allows copying notification titles and messages to clipboard for easy sharing.
Adds cooldown text for free users on a cooldown. Prevents adding a torrent to check.
Disallows free users from adding a torrent if on cooldown or if reached max monthly torrents. The button will simply be greyed out.
Allows for you to see the current active users on TorBox. This is a live number and it shows all users connected to the TorBox Satellite Network.
Fixed error when deleting a torrent.
Downloads
Improved reliability of processing downloads.
Improved seeding speeds.
Saves folder hash to prevent torrents overwriting each other if they have the same name.
API
Added endpoint for viewing current users connected to TorBox Satellite Network. This is part of the relay API (https://relay.torbox.app).
Added endpoint for requesting update for a torrent. This is part of the relay API (https://relay.torbox.app/v1/inactivecheck/torrent/{{user_id}}/{{torrent_id}}). This does not require an API key, just knowing the user's ID and the torrent's ID.
Added endpoint for getting your list of torrents. This requires an API key. (/v1/api/torrents/mylist). This makes it possible to now interact with the rest of the torrent API.
Added endpoint for getting your list of notifications. This requires an API key. (/v1/api/notifications/mynotifications).
Added endpoint for getting your user data. This requires an API key. (/v1/api/user/me).
Updated documentation at https://api-docs.torbox.app.
NOTE: Downloads can still fail at the processing step. GoFile is actively working on the issue, which is a result of TorBox flooding their servers with content (over 50tb in less than a week, and not being able to keep up)
Happy Holidays! TorBox will see you all for a great next year!
\",\n \"markdown\": \"### Website\\n- Added pagination to notifications. If you have more than 5 notifications, you can now view them all using pagination.\\n- Fixed notification popup acting weird at some points.\\n- Allows processing downloads to get updates rather than looking frozen.\\n- Allows copying notification titles and messages to clipboard for easy sharing.\\n- Adds cooldown text for free users on a cooldown. Prevents adding a torrent to check.\\n- Disallows free users from adding a torrent if on cooldown or if reached max monthly torrents. The button will simply be greyed out.\\n- Allows for you to see the current active users on TorBox. This is a live number and it shows all users connected to the TorBox Satellite Network.\\n- Fixed error when deleting a torrent.\\n\\n### Downloads\\n- Improved reliability of processing downloads.\\n- Improved seeding speeds.\\n- Saves folder hash to prevent torrents overwriting each other if they have the same name.\\n\\n### API\\n- Added endpoint for viewing current users connected to TorBox Satellite Network. This is part of the relay API ([***https://relay.torbox.app***](https://relay.torbox.app)).\\n- Added endpoint for requesting update for a torrent. This is part of the relay API ([***https://relay.torbox.app***](https://relay.torbox.app)***/v1/inactivecheck/torrent/{{user\\\\_id}}/{{torrent\\\\_id}}***). This does not require an API key, just knowing the user's ID and the torrent's ID.\\n- Added endpoint for getting your list of torrents. This requires an API key. (***/v1/api/torrents/mylist***). This makes it possible to now interact with the rest of the torrent API.\\n- Added endpoint for getting your list of notifications. This requires an API key. (***/v1/api/notifications/mynotifications***).\\n- Added endpoint for getting your user data. This requires an API key. (***/v1/api/user/me***).\\n- Updated documentation at [https://api-docs.torbox.app](https://api-docs.torbox.app).\\n\\n*NOTE: Downloads can still fail at the processing step. GoFile is actively working on the issue, which is a result of TorBox flooding their servers with content (over 50tb in less than a week, and not being able to keep up)*\\n**Happy Holidays! TorBox will see you all for a great next year!**\\n\",\n \"link\": \"https://feedback.torbox.app/changelog/v32\",\n \"created_at\": \"2023-12-23T03:12:15Z\",\n \"id\": \"65864987710dde9dce23f716\"\n },\n {\n \"name\": \"v3.1.2\",\n \"html\": \"Improved processing times for zipped directories (torrents with over 25 files). The zip is no longer compressed to reduce times, but download times for the end user will be longer by about 10-30% but reduced in processing times by over 100%.
Added a progress count to zipped processing torrents so you can see where it is. Files being zipped accounts for 50% of the progress, the other 50% accounts for the actual upload of the file, which you won't be able to keep track of.
If the torrent fails to process for whatever reason, a notification is sent, so you aren't stuck guessing about its progress.
If you navigate the the main page, torbox.app, when you are logged in, you will be redirected to torbox.app/dashboard instantly so you can start using TorBox faster!
The \\\"You have X notifications waiting in your inbox\\\" is now only shown once per session. If you close your browser, it will show up again, but won't show up if you navigate in and out of the dashboard.
Recently many users have been reporting torrents failing at Processing. This issue has now been generally fixed. The problem was actually timeouts to GoFile's servers and while I had added the timeout fix to almost every GoFile upload, there were some cases (which turned into close to half of all torrents due to a lapse in judgement from me). Another problem which needed addressing is long processing times due to large file count. This has now been addressed by zipping the torrent if it has more than 20 files. Really glad to have fixed this problem on my side. Now we just wait for GoFile to handle their side and make it even more reliable, because this solution still relies on their servers to accept the files and handle them properly.
Fixed Processing hangups due to failed upload.
Fixed Processing times due to large amounts of files.
This update is solely for recovering from the v3 release and getting a few features people wanted in that were pretty simple to get to.
Website
Added progress bars for downloading, paused, and processing torrents. This allows you to quickly see where your torrent is in the process without having to try and find the small print in the specific torrent. This makes it way easier.
Speaking of ease, a quick stats panel will appear on the left side under the download speed chart which allows you to quickly get a view on how many torrents are in your TorBox. It also shows you the status of each of those torrents.
Added a real time online user count so you can see who is using TorBox with you. Not really a necessary thing but the count was already available on the relay so I decided to let you see it too.
Fixed the real time user counter on the relay api.
Fixed downloads not being downloadable on iOS.
Fixed queued downloads not showing up.
Fixed RSS feeds not downloading RSS items.
Fixed RSS scan intervals being editable.
Added the ability to ignore RSS items that are older than X amount of days.
Fixes random 0 when torrent is processing.
Fixes switches in the settings page being weird and out of place on smaller displays.
Fixes Forgot Password, Login with email, and Login with Password buttons being placed out of the login space on smaller displays.
Fixes typo with Availability count (I didn't know what availability in torrents meant, and just slapped a % sign on there thinking it was the percentage of the file which is available which is incorrect)
Fixes torrents not being added in some cases where the torrent file is extremely large.
Mobile App
Fixes layout of dashboard bar where long emails pushed the buttons off of the screen.
API
Fixes user sign ups not granting an API negating access to the app entirely.
Fixes PayPal payments not getting credited.
Fixes Stripe payments not getting credited.
Fixes Coinbase not accepting multiple cryptocurrencies like before (they offered me a beta without me knowing what it was, and I stupidly accepted. Opting out fixed the issue).
API properly sends notification when user submits bad torrent file or magnet link.
NOTE: Zip files are still broken. GoFile is working on the problem and is expected to be fixed within the next few weeks. Thank you for your patience.
\",\n \"markdown\": \"This update is solely for recovering from the v3 release and getting a few features people wanted in that were pretty simple to get to.\\n### **Website**\\n- Added progress bars for *downloading*, *paused*, and *processing* torrents. This allows you to quickly see where your torrent is in the process without having to try and find the small print in the specific torrent. This makes it way easier.\\n- Speaking of ease, a quick stats panel will appear on the left side under the download speed chart which allows you to quickly get a view on how many torrents are in your TorBox. It also shows you the status of each of those torrents.\\n- Added a real time online user count so you can see who is using TorBox with you. Not really a necessary thing but the count was already available on the relay so I decided to let you see it too.\\n - Fixed the real time user counter on the relay api.\\n \\n- Fixed downloads not being downloadable on iOS.\\n- Fixed queued downloads not showing up.\\n- Fixed RSS feeds not downloading RSS items.\\n- Fixed RSS scan intervals being editable.\\n- Added the ability to ignore RSS items that are older than X amount of days.\\n- Fixes random 0 when torrent is processing.\\n- Fixes switches in the settings page being weird and out of place on smaller displays.\\n- Fixes **Forgot Password**, **Login with email**, and **Login with Password** buttons being placed out of the login space on smaller displays.\\n- Fixes typo with **Availability** count (I didn't know what availability in torrents meant, and just slapped a % sign on there thinking it was the percentage of the file which is available which is incorrect)\\n- Fixes torrents not being added in some cases where the torrent file is extremely large.\\n\\n### **Mobile App**\\n- Fixes layout of dashboard bar where long emails pushed the buttons off of the screen.\\n\\n### **API**\\n- Fixes user sign ups not granting an API negating access to the app entirely.\\n- Fixes PayPal payments not getting credited.\\n- Fixes Stripe payments not getting credited.\\n- Fixes Coinbase not accepting multiple cryptocurrencies like before (they offered me a beta without me knowing what it was, and I stupidly accepted. Opting out fixed the issue).\\n- API properly sends notification when user submits bad torrent file or magnet link.\\n\\n## *NOTE: Zip files are still broken. GoFile is working on the problem and is expected to be fixed within the next few weeks. Thank you for your patience.*\\n\",\n \"link\": \"https://feedback.torbox.app/changelog/v31\",\n \"created_at\": \"2023-12-12T23:58:02Z\",\n \"id\": \"6578ee269ed2047ada8ae663\"\n },\n {\n \"name\": \"v3.0\",\n \"html\": \"Today is a really special day, with almost 2 months in the making, I would like to introduce to you, v3.0, TorBox's largest update ever. In v3.0 we introduce highly asked for things such as better and more integrations, queues, a mobile app, and better seeding, not to mention the dozens of bugs fixed.
Before we get any further into this absolutely monstrous set of release notes, I would first like to thank the users of my Discord server for being able to test and give feedback on TorBox ever since the very beginning, you guys made it as good as it is today. I would also like to thank TorBox's first partner, GoFile.io! They are the stars of the show for this update, so please go check out their service and perhaps purchase a premium account from them, as even I use them outside of TorBox.
Now let's get into the fun stuff. Because this changelog is so big, each section has been divided with the changes that pertain to it. Sorry for the book, I think my English professor would be proud.
Website
Landing Page
A prettier landing page with cool effects and more information.
Sparkles, mouse effects, scroll effects, glow effects, what more could you possibly ask for?
Notifications
Added a close button to all notifications. Some notifications popped up right when you are trying to do something, so dismissing them is now available. The notification will still be available to view in your notifications panel.
(More) descriptive notifications.
Dashboard
You are no longer alerted of the notification count if you leave the dashboard and come back. Only shows the first time you view the dashboard.
Torrents now show availability percentage, so you know if you are fully able to download a torrent or not.
Torrents that are being processed (uploaded to GoFile) will be shown as \\\"Processing\\\" on the dashboard (in blue).
Removed the ability to add web downloads. This will come back in a future update. There were too many problems with it, and I decided to skip migrating web downloads to v3 as well.
Downloads (Download Page)
Improved the Google Drive integration. Finally, Rclone is viable, as well as other cloud setups.
No longer have to be present on the download page. Once you click the button and log in, it downloads in the background on the servers, which us much faster compared to before.
Log in is more reliable. Sometimes due to cookies, browser differences, or other weird things, you could never add the file to Google Drive.
Fixed naming of files. Before they would be URLEncoded, which made it safer, but also made the files look weird.
Faster downloads thanks to GoFile.io. This also includes making all downloads resume capable.
Added OneDrive integration. Some users were requesting thanks to school or business accounts having infinite storage.
Same as the Google Drive integration except for OneDrive. Simply click the button, log in, and it will begin working.
This is the fastest way to add your files to the cloud out of any of the integrations thanks to being able to upload 60MB at a time to the cloud rather than only 256KB in the case of Google Drive.
Added the ability to use the all integrations with folders (zip files). This way, for torrents with a lot of files, you can just click one button rather than many. All integrations work with the zip files (Google Drive, Dropbox, and OneDrive).
Zip files are now support multi-connection downloads thanks to GoFile supporting it.
You can no longer view files on TorBox, you must go to GoFile.io. The same button takes you to the specific file where you can then view the file, much like you used to do on TorBox.
You can now share download links with others thanks to GoFile.io. Simply click the share button, and the link will be copied to your clipboard, where you can share it with anyone online.
Downloads are now supplied by GoFile.io. This decision was made for scalability and the future of TorBox. While it sucks having to rely on another service to handle downloads for TorBox, there are many benefits to doing so.
The first and most important reason for this change is that seeding/downloading speeds are much faster. With essentially no load on the hard drives (other than uploading to GoFile once), this frees up precious IOPS needed to hit high transfer speeds. Before, downloads were made from the same file that the server was seeding from meaning that the load on the drives were so much that sometimes downloads would crawl to a stop. This is no longer the case thanks to GoFile's excellent CDN and reliability, you will be able to download at or near your bandwidth speed.
The second is that it gives TorBox more room to grow, thanks to a lower budget needed for servers, we can put more money into features, integrations, marketing and more for the best experience.
The final reason is scaling and the future of TorBox. If we suddenly got an onslaught of users who all downloaded more than 30TB in 24 hours, we wouldn't have been able to keep up, but with GoFile and their seemingly infinite storage, this is no longer a problem. A sudden burst wouldn't cripple the service for anyone else.
Torrents
Prevents duplicate torrents. You can no longer have multiple of the same torrent on your dashboard.
For users on a paid plan, you can now queue up as many torrents as you want. Simply continue to add torrents on your dashboard, even if you have hit your active limit. Once you delete a torrent, or one becomes inactive, TorBox will automatically begin downloading the next one in line (after some time delay due to the check only happening every 10 minutes or so to save processing although as soon as you delete a torrent, it will begin downloading the next one).
There is no limit to how many you add to the queue, they will be downloaded in order and as soon as you have available slots.
Currently, you cannot move the order of the queue. There will be a way to modify the order in a future update.
To remove an item from the queue, simply delete it.
Fixes error on quick add page that requires you to click the Add button
2 times to add it, which was annoying.
RSS Feeds
Pro users are now able to add RSS feeds and automatically download torrents (almost) as soon as they are available.
RSS feeds require the following to be added:
An RSS feed URL. Must be publicly accessible. Must have .torrent link files that are also publicly accessible.
A name. This can be any name, which allows you to quickly recognize what an RSS feed is.
RSS feeds can optionally have the following as well:
A download this regex pattern which forces the reader to download all torrents that match this regex.
A ignore this regex pattern which forces the read to ignore torrents that match this regex.
A scan interval which tells the API how often to check for changes in your RSS feed. The default is 60 minutes, but can go all the way down to 10 minutes if you like to stay on top of things. You can also set this to be as long as you want.
You can add as many RSS feeds as you like, and downloads will be queued up if you run out of active slots.
You are able to edit RSS feeds if you want to change the display name, the scan interval or the regex patterns.
You are also able to force updates, pause, resume, and delete RSS feeds.
Forcing an update simply scans the RSS feed and downloads anything new automatically.
API
There is now a public API available. It does not have everything you need just yet, and is still in Alpha, but generally, it is ready to use, as the site itself uses it.
You can view documentation at https://api-docs.torbox.app or by clicking API docs under the development section of the footer anywhere it is available.
The docs are all written in Postman so you are able to run it in Postman to try it out.
For most endpoints there are examples as well as variables so you can enter whatever you like there.
All users get an API key that they can use to access the API. You can view your API key in the settings page.
Mobile App
A fully featured mobile app is now available for Android devices (iOS coming soon). This allows you to take TorBox on the go with a native app, rather than using the website.
To access the app, you must have assigned a password to your account. This can be done by going to the TorBox settings page.
You can do everything you can do on the website, except for downloading torrents (takes you to the browser where you have to be logged in anyways) as well as managing RSS feeds.
The mobile app is mainly used for notifications to be received anywhere you are on your mobile device. As soon as something happens on your TorBox account, you will know about it, such as downloads being complete, errors, or payments going through. You can also quickly view your torrents as well as manage them.
With all that said, please expect bugs and minor downtimes within the next few weeks as I get everything stable once again. Keeping a service like this has gotten so complex for just one person, so please be patient with me. Thanks all!
\",\n \"markdown\": \"Today is a really special day, with almost 2 months in the making, I would like to introduce to you, v3.0, TorBox's largest update ever. In v3.0 we introduce highly asked for things such as better and more integrations, queues, a mobile app, and better seeding, not to mention the dozens of bugs fixed.\\nBefore we get any further into this absolutely monstrous set of release notes, I would first like to thank the users of my [Discord server](https://discord.gg/47SnjxgBFb) for being able to test and give feedback on TorBox ever since the very beginning, you guys made it as good as it is today. I would also like to thank TorBox's first partner, [GoFile.io](http://GoFile.io)! They are the stars of the show for this update, so please go check out their service and perhaps purchase a premium account from them, as even I use them outside of TorBox. \\nNow let's get into the fun stuff. Because this changelog is so big, each section has been divided with the changes that pertain to it. Sorry for the book, I think my English professor would be proud.\\n## **Website**\\n### *Landing Page*\\n- A prettier landing page with cool effects and more information.\\n- Sparkles, mouse effects, scroll effects, glow effects, what more could you possibly ask for?\\n\\n### *Notifications*\\n- **Added a close button to all notifications**. Some notifications popped up right when you are trying to do something, so dismissing them is now available. The notification will still be available to view in your notifications panel.\\n- (More) descriptive notifications.\\n\\n### *Dashboard*\\n- You are no longer alerted of the notification count if you leave the dashboard and come back. Only shows the first time you view the dashboard.\\n- Torrents now show availability percentage, so you know if you are fully able to download a torrent or not.\\n- Torrents that are being processed (uploaded to GoFile) will be shown as \\\"Processing\\\" on the dashboard (in blue).\\n- **Removed the ability to add web downloads**. This will come back in a future update. There were too many problems with it, and I decided to skip migrating web downloads to v3 as well.\\n\\n### *Downloads (Download Page)*\\n- Improved the Google Drive integration. Finally, Rclone is viable, as well as other cloud setups.\\n - No longer have to be present on the download page. Once you click the button and log in, it downloads in the background on the servers, which us much faster compared to before.\\n - Log in is more reliable. Sometimes due to cookies, browser differences, or other weird things, you could never add the file to Google Drive.\\n - Fixed naming of files. Before they would be URLEncoded, which made it safer, but also made the files look weird.\\n - Faster downloads thanks to [GoFile.io](http://GoFile.io). This also includes making all downloads resume capable.\\n \\n- **Added OneDrive integration**. Some users were requesting thanks to school or business accounts having infinite storage.\\n - Same as the Google Drive integration except for OneDrive. Simply click the button, log in, and it will begin working.\\n - This is the fastest way to add your files to the cloud out of any of the integrations thanks to being able to upload 60MB at a time to the cloud rather than only 256KB in the case of Google Drive.\\n \\n- Added the ability to use the all integrations with folders (zip files). This way, for torrents with a lot of files, you can just click one button rather than many. All integrations work with the zip files (Google Drive, Dropbox, and OneDrive).\\n- Zip files are now support multi-connection downloads thanks to GoFile supporting it.\\n- You can no longer view files on TorBox, you must go to [GoFile.io](http://GoFile.io). The same button takes you to the specific file where you can then view the file, much like you used to do on TorBox.\\n- You can now share download links with others thanks to [GoFile.io](http://GoFile.io). Simply click the share button, and the link will be copied to your clipboard, where you can share it with anyone online.\\n- **Downloads are now supplied by **[**GoFile.io**](http://GoFile.io)**. **This decision was made for scalability and the future of TorBox. While it sucks having to rely on another service to handle downloads for TorBox, there are many benefits to doing so.\\n - The first and most important reason for this change is that seeding/downloading speeds are much faster. With essentially no load on the hard drives (other than uploading to GoFile once), this frees up precious IOPS needed to hit high transfer speeds. Before, downloads were made from the same file that the server was seeding from meaning that the load on the drives were so much that sometimes downloads would crawl to a stop. This is no longer the case thanks to GoFile's excellent CDN and reliability, you will be able to download at or near your bandwidth speed.\\n - The second is that it gives TorBox more room to grow, thanks to a lower budget needed for servers, we can put more money into features, integrations, marketing and more for the best experience.\\n - The final reason is scaling and the future of TorBox. If we suddenly got an onslaught of users who all downloaded more than 30TB in 24 hours, we wouldn't have been able to keep up, but with GoFile and their seemingly infinite storage, this is no longer a problem. A sudden burst wouldn't cripple the service for anyone else.\\n \\n\\n### *Torrents*\\n- Prevents duplicate torrents. You can no longer have multiple of the same torrent on your dashboard.\\n- For users on a paid plan, you can now **queue up as many torrents as you want**. Simply continue to add torrents on your dashboard, even if you have hit your active limit. Once you delete a torrent, or one becomes inactive, TorBox will automatically begin downloading the next one in line (after some time delay due to the check only happening every 10 minutes or so to save processing although as soon as you delete a torrent, it will begin downloading the next one).\\n - There is no limit to how many you add to the queue, they will be downloaded in order and as soon as you have available slots.\\n - Currently, you cannot move the order of the queue. There will be a way to modify the order in a future update.\\n - To remove an item from the queue, simply delete it.\\n \\n- Fixes error on quick add page that requires you to click the Add button\\n 2 times to add it, which was annoying.\\n\\n### *RSS Feeds*\\n- Pro users are now able to add RSS feeds and automatically download torrents (almost) as soon as they are available.\\n - RSS feeds require the following to be added:\\n - An RSS feed URL. Must be publicly accessible. Must have .torrent link files that are also publicly accessible.\\n - A name. This can be any name, which allows you to quickly recognize what an RSS feed is.\\n \\n - RSS feeds can optionally have the following as well:\\n - A *download this* regex pattern which forces the reader to download all torrents that match this regex.\\n - A *ignore this* regex pattern which forces the read to ignore torrents that match this regex.\\n - A scan interval which tells the API how often to check for changes in your RSS feed. The default is 60 minutes, but can go all the way down to 10 minutes if you like to stay on top of things. You can also set this to be as long as you want.\\n \\n \\n- You can add as many RSS feeds as you like, and downloads will be queued up if you run out of active slots.\\n- You are able to edit RSS feeds if you want to change the display name, the scan interval or the regex patterns.\\n- You are also able to force updates, pause, resume, and delete RSS feeds.\\n - Forcing an update simply scans the RSS feed and downloads anything new automatically.\\n \\n\\n---\\n## **API**\\n- There is now a public API available. It does not have everything you need just yet, and is still in Alpha, but generally, it is ready to use, as the site itself uses it.\\n- You can view documentation at [https://api-docs.torbox.app](https://api-docs.torbox.app) or by clicking API docs under the development section of the footer anywhere it is available.\\n - The docs are all written in Postman so you are able to run it in Postman to try it out.\\n - For most endpoints there are examples as well as variables so you can enter whatever you like there.\\n \\n- All users get an API key that they can use to access the API. You can view your API key in the [settings page](https://torbox.app/settings).\\n\\n---\\n## **Mobile App**\\n- A fully featured mobile app is now available for Android devices (iOS coming soon). This allows you to take TorBox on the go with a native app, rather than using the website.\\n - To access the app, you must have assigned a password to your account. This can be done by going to the [TorBox settings page](https://torbox.app/settings).\\n \\n- You can do everything you can do on the website, except for downloading torrents (takes you to the browser where you have to be logged in anyways) as well as managing RSS feeds.\\n- The mobile app is mainly used for notifications to be received anywhere you are on your mobile device. As soon as something happens on your TorBox account, you will know about it, such as downloads being complete, errors, or payments going through. You can also quickly view your torrents as well as manage them.\\n \\n\\n*With all that said, please expect bugs and minor downtimes within the next few weeks as I get everything stable once again. Keeping a service like this has gotten so complex for just one person, so please be patient with me. Thanks all!*\\n\",\n \"link\": \"https://feedback.torbox.app/changelog/v30\",\n \"created_at\": \"2023-12-07T09:36:53Z\",\n \"id\": \"65666cf0d4d0815b04cee64e\"\n },\n {\n \"name\": \"v2.6.1\",\n \"html\": \"Website
Made torrent files more reliable than ever before due to new process regarding how they are handled on the server.
Torrent files now show the original name of the torrent file when uploading. Before it was something like:
some_uuid-name_of_torrent, now it is simply the name of the torrent.If you are unsubscribed from web notifications, you will no longer receive a toast about how many notifications you have in your inbox.
The zip file download button now clicks right through and only activates when you hover over it. Before, you had to click twice to open the menu, which is unsavory. Now you simply click to open the menu.
Mobile App
Replaces popups in app with toasts, much like the website has. This way you don't have to click a confirmation button every time you modify something, or get an error.
Another new version, this time with awesome new stuff and fixes for both the mobile app and website!
Website
Lets users know when they have a notification on the dashboard with a notifier whenever they enter the dashboard.
Some users were having troubles with knowing when they had a notification due to the badge being quite small and out of the way.
Whenever a web notification is sent, if the user does not subscribe to desktop notifications, then on the dashboard they will get a notification.
Some users were having troubles knowing when they had a notification, which resulted in confusion when a torrent for instance had an error.
Some devices can't get desktop notifications such as mobile devices, so this fixes the issue for mobile devices not seeing notifications as soon as they happen.
UI update with buttons. Updated all buttons on the site to be the same style to resolve some confusion on what is or is not a button.
Affects the Enable Desktop Notifications button on the notifications panel.
Affects the Clear All button on the notifications panel.
Affects the Settings button on the user panel.
Affects the Logout button on the user panel.
Fixes a bug where a torrent would never be marked as Ready To Download due the hash being present on another server, even if the file wasn't available on the current server.
Added Reddit, Telegram, and Matrix links in the footer.
Adds option to settings to register TorBox to handle magnet links automatically. Whenever you click on one, it will open TorBox with the magnet link so you can add it.
Fixed About page showing the correct number of satellites.
Optimized seeding on torrents.
Mobile App
Adds controlling torrents using popup, much like the current website does. Does everything the current site does such as Downloading, Sharing, Reannouncing, Pausing/Playing, and Deleting.
Makes header area smaller, taking up less of the screen.
General bug fixes.
Website
Makes file names back to normal again rather than brackets, spaces, and other misc punctuation being URL safe.
General fixes.
Mobile App
Fixes white flash when opening the app.
Adds live updates to the app, meaning you no longer have to manually refresh. You also no longer have to have the website open at the same time as the app to receive updates. As long as you are on the app, your torrents will live-update.
Download URL takes you to TorBox download page for that download, meaning you don't have to navigate from the dashboard, to the download page for that torrent, those steps are now skipped for you.
Fixes emails that are too long going off of the screen.
General fixes.
Fixes downloads being set as inactive prematurely.
Fixes torrent files showing up as the wrong torrents in the UI.
Fixes slow download speeds.
Revamps interaction menu for torrents and webdownloads for a cleaner looks and easier UI to use.
Adds button for Reannouncing torrents.
Adds button for Pausing/Resuming torrents.
Yes, you can now Reannounce torrents, which will get you better seeds (most of the time), or better peers too (most of the time). Will solve some issues for bigger torrents getting bad seeds and downloading slowly.
You can now pause and resume torrents, which will allow you to get better download speeds, or if you choose, just stop seeding to everyone. Your choice!
Fixes a few bugs.
Look at this, no actually, look. You can now look at your torrents in the browser!
You can now watch videos in the browser straight from the server, without actually downloading the file beforehand! Enjoy fast streaming wherever you are. This will be going under heavy use so if it begins to be a problem, we will have to heavily rate limit if it begins to be a problem.
You can now listen to music in the browser too.
You can look at downloaded images in the browser.
You can view text files as well. No PDF yet, but if enough people request it, we can add it. Didn't seem worth the trouble right now.
Fixed bug with web notifications not showing.
It's a new version! With this version we introduce notifications and the highly asked for, passwords.
Introduces the settings page, where you can edit notifications, your plan, and other settings as well as new ones coming soon. These settings are also all cloud saved, so they will all travel to any device you use TorBox on.
Allows you to change your password by getting a password reset email.
Allows you to add more time, subscribe to a higher plan, and view the Stripe Dashboard.
Allows you to modify your notifications settings.
Allows you to enable/disable Email Notifications.
Allows you to enable/disable Web Notifications.
Allows you to enable/disable Mobile Notifications (which aren't available yet, but coming soon!)
Allows you to enable/disable RSS Feed Notifications as well as copy your RSS Feed link.
Allows you to modify your site settings.
Allows you to show download speed in the tab name for easy viewing.
Email Notifications allow you to receive notifications for everything such as payments, referrals, and downloads straight to your inbox. Is off by default to reduce spam.
Web Notifications allow you to receive notifications from the site and if the site is open, and desktop notifications are enabled, you can get desktop notifications. This is on by default and was the original way for notifications. Basically just allows you to disable viewing them if you want.
Mobile Notifications will allow you to download the mobile app (coming soon!) and receive push notifications straight to your device to get the latest updates.
RSS Feed Notifications shows your notifications in an RSS feed which can be used anywhere. Useful for users who have other notifications in RSS.
Passwords are now available to add to your account, allowing you to skip sending emails every time you want to log in. Useful for users with password managers for quick logins. Also having a password will allow you to use other upcoming TorBox services such as Persistent Storage, FTP, SFTP, S3, and more!
Allows you to send a password reset email from going to the settings page and clicking the Send Password Reset Email, or by going to the Forgot Password page, which will allow you to enter your email and get a password reset email.
If you want to bookmark the login page with the email/password entry bookmark this site.
New Satellite, Nebula, a satellite specifically for our Essential and Standard Users. Before Essential, Standard and Free users all had to same the same server and that meant bandwidth too. We were running out too quickly (we went through 100TB in less than 2 weeks) so we decided to move servers around and that meant getting a new one.
Stellar's download speeds (from server to your PC) has been reduced to 10MB/s rather than full speed which was where all the bandwidth is going. Hopefully this will allow us to stretch 100TB a little further. We are planning to move to unmetered servers soon, but it's a little out of budget. If you want to help support TorBox, sign up for a paid plan!
All other servers are full speed.
Squashed some bugs 🐛
Fixes oversized downloads not removing cooldown
Allows for downloading web downloads from anywhere.
Fixed bug with torrent files that had trouble uploading due to not being previously deleted.
Fixed cached torrents not being detected correctly.
Fixed inactive downloads being cached when they weren't supposed to be.
Allows for torrent files to be up to 10MB big. Some users were having troubles with the 1MB limit.
Fixed cached downloads not being added properly if torrent has already been deleted. In the case where the torrent is already expired, then the torrent is not cached, and the user will be able to start a download like normal. Before, even expired downloads counted as cached.
Fixed Stripe upgrading/downgrading plans not taking effect.
Torrents now expire properly instead of saying Download expires 1 week ago.
Torrents now don't require a user to look at it to make it inactive. Every 30 minutes all torrents are checked for expired files, as cached downloads require an accurate measurement of expired vs not expired torrents.
Fixed download names not showing proper name or extension if downloaded too quickly through browser. If you are using a download manager, you still have to wait until the file is resolved before downloading, or the name won't show up properly. This is a zero day problem and requires high optimization of the API to work perfectly. This is high on the list of things to fix.
Further small bug fixes on the website side of things.
Moved main processes such as API and Relay to new more (overpowered) powerful server.
This will give better response times for requests so you aren't waiting as long for a torrent to be added for example.
The relay will scale further allowing for it to work better and more efficiently.
The download graph to only show values above 0.
The download graph now scales properly and shows proper speeds.
Better relay efficiency and stability (ie: your torrents should be properly updating now).
Adds proper error pages for any errors on the satellites.
Fixed Coinbase payments not giving altering user's satellite if upgrading.
Optimized web pages.
Main page gradient now moves a bit faster, making a cooler effect.
Minor update that introduces TorBox's awesome new community requested plan! This release also fixes a lot of bugs that have been springing up, as well as another rewrite, this time of the relay (was not fun).
Introduces the new Standard Plan. This plan is aimed at users who want to use TorBox with private trackers who require at least a week of seeding, but don't need all of the features that the Pro plan has.
Allows for 5 active downloads.
Allows for 2 week (14 day) seeding.
Other than those 2 changes, it is the same as the Essential Plan.
Rewrote the relay to allow for scalability (yes, I have already rewritten the relay once in v2.0). This time it introduces a queue, so instead of all these requests trying to be done at the same time it processes 10 at a time, per worker, meaning with scale, I could make it even faster.
Mainly addresses the issues of downloads not being updated on the dashboard.
Honestly, this doesn't affect the user, as it is now working exactly how it is supposed to, LOL.
Removed Sentry bug popup. Whenever an error would happen, safe or unsafe, it would popup this window which severely impacted the user experience, as it would usually popup on \\\"safe\\\" errors or errors that don't affect anything, which would be very annoying, so it is removed.
Optimized the website, so on average it should be almost 10% faster regarding opening and closing pages. This will only really affect users on mobile devices on cellular data.
These changes aren't very noticeable, but ensures that TorBox is easy and feels good to use.
\",\n \"markdown\": \"Minor update that introduces TorBox's awesome new community requested plan! This release also fixes a lot of bugs that have been springing up, as well as another rewrite, this time of the relay (was not fun).\\n- Introduces the new **Standard Plan**. This plan is aimed at users who want to use TorBox with private trackers who require at least a week of seeding, but don't need all of the features that the Pro plan has.\\n - Allows for 5 active downloads.\\n - Allows for 2 week (14 day) seeding.\\n - Other than those 2 changes, it is the same as the Essential Plan.\\n \\n- Rewrote the relay to allow for scalability (yes, I have already rewritten the relay once in v2.0). This time it introduces a queue, so instead of all these requests trying to be done at the same time it processes 10 at a time, per worker, meaning with scale, I could make it even faster.\\n - Mainly addresses the issues of downloads not being updated on the dashboard.\\n - Honestly, this doesn't affect the user, as it is now working exactly how it is supposed to, LOL.\\n \\n- Removed Sentry bug popup. Whenever an error would happen, safe or unsafe, it would popup this window which severely impacted the user experience, as it would usually popup on \\\"safe\\\" errors or errors that don't affect anything, which would be very annoying, so it is removed.\\n- Optimized the website, so on average it should be almost 10% faster regarding opening and closing pages. This will only really affect users on mobile devices on cellular data.\\n\\nThese changes aren't very noticeable, but ensures that TorBox is easy and feels good to use.\\n\",\n \"link\": \"https://feedback.torbox.app/changelog/v24\",\n \"created_at\": \"2023-10-07T01:56:44Z\",\n \"id\": \"6520b8c5651678b3e0b87226\"\n },\n {\n \"name\": \"v2.3.1\",\n \"html\": \"Adds allowing to buy multiple months of service at once.
1 Month
3 Months
12 Months (1 Year)
Adds Discord widget allowing you to view recent Discord announcements. Logging in to the widget using your Discord account, allows you to chat from the widget while on the site.
Minor bug fixes.
If you ever encounter an error, there will be a popup, asking for feedback on the error, which will help notify me of anything wrong. If you ever see that, please fill it out!
Another release so soon? Here are some improved and asked for features.
Added proper tooltip for download page. Before it would still be present if you clicked on the button.
Added tooltips for the following UI elements:
Download \\\"Created At\\\" date shows exact date on hover.
Download \\\"Expires At\\\" date shows exact date on hover.
For downloads with ratio \\\"Ratio\\\", shows the exact ratio to the thousandths position. (0.000)
For users with a paid plan, the \\\"plan expires _____\\\" text shows the exact date it will expire on hover.
Referrals now actually give the deserved days. Before they weren't given to all users who entered a valid referral code.
Made all payment types more reliable. Before the dates were getting messed up depending on when you made your account? That was a weird one, but it's all fixed (hopefully).
Payments were rewritten to allow for quantities for future use.
On the dashboard page, added a support button, which allows you to easily contact support, with resumability which means you can leave and come back whenever you want and will have responses waiting for you (this is huge, basically you can leave and the ticket will stay open). This support button also allows you to read about any problems you might have, using the articles.
On the dashboard page, added a feedback button, which shows the featurebase changelog and also requested features. Simply easy access for featurebase.
Made web download download speeds show on the download graph.
You can now see how many total downloads you have done. This is located in the avatar button popup, below your satellite name and IP. If you have over 50 downloads, it will show a cool flame icon, showing just how on fire you are!
Added a list of available links that are allowed to download using the web download feature.
Fixed invalid web download links still giving a cooldown.
Added Sentry tracking for all satellites, the api, and the relay.
Web Downloads! Well, at least the beginning of them. This update was mostly laying the ground work for future possibilities. Regarding changes that will actually affect you, the user, nothing major. This was more of a backend/api/database type of update, but it did add some web downloads, so that is pretty cool.
Added support to download URLs from the web.
Only supports links from this list for now.
Download links have a new structure. Not that most people would care, but if you have links saved somewhere, and are trying to redownload them, they will fail due to the change.
For torrent files: /file/torrents/<<id>>/<<id>>
For zipped torrents: /zip/torrents/<<id>>
For webdownload files: /file/web_downloads/<<id>>/<<id>>
For zipped webdownloads: /zip/web_downloads/<<id>>/<<id>>
Yup, that's literally it. Like I said, nothing big regarding massive changes or features, but this is a huge stepping point for the code, and the service itself. With this change, the possibilities to add all types of downloads are endless thanks to the semi-modularity that is built in (I will do better).
Regarding supporting sites, I have to match specific domains to make it work, so if you have a specific site you would like to add, DM me on Discord, open a support ticket on the Discord server, or send an email at contact@torbox.app and I will see what I can do. No, I will not be adding sites like rapid-gator. LeechersParadise is dead and those sites are too hard to maintain. Go pay for All-Debrid or Real-Debrid. TorBox is primarily for torrents. 1Fichier and UpToBox may be possible, but staying on top of things for those types of sites is hard.
Fixes PayPal problems people were having.
Fixes Coinbase problems people were having.
Fixes Zip downloads for files over 4GB.
Faster Zip downloads
Zip files now show total size.
Zip files are still not multi-connection like single downloads. That will come soon.
\",\n \"markdown\": \"- Fixes PayPal problems people were having.\\n- Fixes Coinbase problems people were having.\\n- Fixes Zip downloads for files over 4GB.\\n- Faster Zip downloads\\n- Zip files now show total size.\\n\\n**Zip files are still not multi-connection like single downloads. That will come soon.**\\n\",\n \"link\": \"https://feedback.torbox.app/changelog/v21\",\n \"created_at\": \"2023-09-24T19:14:27Z\",\n \"id\": \"65108a1b66279bfaa09fecad\"\n },\n {\n \"name\": \"v2.0.4\",\n \"html\": \"Fixes cached torrents not showing all needed info.
Some users were reporting seeing the torrent at 100% but no \\\"Download Ready\\\" status.
Fixes error messages saying \\\"None\\\" in the text.
Small UI update. Adds some small fixes and viewing satellite information.
Minor UI changes
Adds viewing and copying the primary satellite's IP for private torrents. This button will be moved to the settings section eventually.
Simply click on the green IP like the one in the screenshot to copy it.
Shows the a user's primary satellite's name
![](\\\"https://fb-usercontent.fra1.cdn.digitaloceanspaces.com/1695533805037.png\\\")
^-- This is what it looks like. Pretty neat! Soon a settings button will go there so you can configure more settings.
\",\n \"markdown\": \"Small UI update. Adds some small fixes and viewing satellite information.\\n- Minor UI changes\\n- Adds viewing and copying the primary satellite's IP for private torrents. This button will be moved to the settings section eventually.\\n - Simply click on the green IP like the one in the screenshot to copy it.\\n \\n- Shows the a user's primary satellite's name\\n\\n* ^-- This is what it looks like. Pretty neat! Soon a settings button will go there so you can configure more settings.*\\n\",\n \"link\": \"https://feedback.torbox.app/changelog/v203\",\n \"created_at\": \"2023-09-24T05:38:02Z\",\n \"id\": \"650fca75ea03ffc65294e841\"\n },\n {\n \"name\": \"v2.0.2\",\n \"html\": \"Security Patch. Bans user's who use the same base email.
Bans any new user who signs up using the \\\"+\\\" trick, such as signing up multiple accounts such as hello+torbox1@gmail.com and hello+torbox2@gmail.com etc.
Users will be banned at sign up who attempt to bypass this.
Users will not be able to log in.
Ban is for 100 years.
No message is shown. You just won't be able to log in.
Please stop trying to take advantage of TorBox! If you try, I'll figure out how and patch it.
\",\n \"markdown\": \"Security Patch. Bans user's who use the same base email.\\n- Bans any new user who signs up using the \\\"+\\\" trick, such as signing up multiple accounts such as [*hello+torbox1@gmail.com*](mailto:hello+torbox1@gmail.com) and [*hello+torbox2@gmail.com*](mailto:hello+torbox2@gmail.com) etc.\\n - Users will be banned at sign up who attempt to bypass this.\\n - Users will not be able to log in.\\n - Ban is for 100 years.\\n - No message is shown. You just won't be able to log in.\\n \\n\\nPlease stop trying to take advantage of TorBox! If you try, I'll figure out how and patch it.\\n\",\n \"link\": \"https://feedback.torbox.app/changelog/v202\",\n \"created_at\": \"2023-09-23T08:31:36Z\",\n \"id\": \"650ea18e8fd5d499ffd3f6b8\"\n },\n {\n \"name\": \"v2.0.1\",\n \"html\": \"Security Patch. Bans user's who use fake emails.
Bans any new users who use any fake email services from this list.
Users banned will not be registered as a \\\"customer\\\" and will not get access to the satellite cluster network
Users will not be able to log in.
Ban is for 100 years.
No message is shown, you just won't be able to log in.
Well, version 2. It has been a lot of bug fixes. A lot of new features. A lot of new designs. Here are some interesting stats:
Frontend
37 hours, 2 minutes spent coding
169 commits
Backend
63 hours, 7 minutes spent coding
194 commits
That's a lot of time to get to this point. Its something to be proud of though. So far the service is the best looking UI I have ever built, thanks to Fero. Not just the design, but other than a few other projects, (and after the rewrite) this is my most bullet proof API as well. It was a lot to get to this point, but I want to thank everyone in my Discord as well as other service who gave me very constructive advice and bugs to fix. All that time together, we have created something awesome and something that I believe will last for a long time. Enough with the gushy stuff, here is what has changed.
The IDM and Jdownloader buttons have been combined into one \\\"Add to Download Manager\\\" button. This also \\\"allows\\\" user for users who like pyload or downthemall without making things confusing.
Downloading folders is a little bit more intuitive and user friendly thanks to the popup. You can now see exactly what buttons do.
The \\\"Currently ______\\\" text on the torrents has been made a little bit more intuitive and user friendly as some of the previous statuses were a little difficult to understand.
Torrents are now triple checked before being marked as \\\"Inactive\\\" and not being allowed to download anymore.
Torrents on the dashboard actually update now. IDK what I did to break it, but it's fixed now.
Rewrote the satellite network to be more like a cluster rather than forcing a torrent to only go to one satellite. Instead its now distributed based off of load, storage space, and other factors.
You now get web notifications when the torrent has gone inactive.
Added bot detection using Cloudflare's turnstile for logging in.
When adding torrrents, only free user's have to wait for the captcha to complete. If you are on a paid plan, you get to skip the captcha process (takes less than 5 seconds).
The satellite relays can now handle infinite users rather than crashing on high load.
I am excited to continue working on this project, and hopefully the launch on Reddit in a few days goes well. This will bring a lot of new users to TorBox.
\",\n \"markdown\": \"Well, version 2. It has been a lot of bug fixes. A lot of new features. A lot of new designs. Here are some interesting stats:\\n**Frontend**\\n37 hours, 2 minutes spent coding\\n169 commits\\n**Backend**\\n63 hours, 7 minutes spent coding\\n194 commits\\nThat's a lot of time to get to this point. Its something to be proud of though. So far the service is the best looking UI I have ever built, thanks to Fero. Not just the design, but other than a few other projects, (and after the rewrite) this is my most bullet proof API as well. It was a lot to get to this point, but I want to thank everyone in my Discord as well as other service who gave me very constructive advice and bugs to fix. All that time together, we have created something awesome and something that I believe will last for a long time. Enough with the gushy stuff, here is what has changed.\\n- The IDM and Jdownloader buttons have been combined into one \\\"Add to Download Manager\\\" button. This also \\\"allows\\\" user for users who like pyload or downthemall without making things confusing.\\n- Downloading folders is a little bit more intuitive and user friendly thanks to the popup. You can now see exactly what buttons do.\\n- The \\\"Currently \\\\_\\\\_\\\\_\\\\_\\\\_\\\\_\\\" text on the torrents has been made a little bit more intuitive and user friendly as some of the previous statuses were a little difficult to understand.\\n- Torrents are now triple checked before being marked as \\\"Inactive\\\" and not being allowed to download anymore.\\n- Torrents on the dashboard actually update now. IDK what I did to break it, but it's fixed now.\\n- Rewrote the satellite network to be more like a cluster rather than forcing a torrent to only go to one satellite. Instead its now distributed based off of load, storage space, and other factors.\\n- You now get web notifications when the torrent has gone inactive.\\n- Added bot detection using Cloudflare's turnstile for logging in.\\n- When adding torrrents, only free user's have to wait for the captcha to complete. If you are on a paid plan, you get to skip the captcha process (takes less than 5 seconds).\\n- The satellite relays can now handle *infinite* users rather than crashing on high load.\\n\\nI am excited to continue working on this project, and hopefully the launch on Reddit in a few days goes well. This will bring a lot of new users to TorBox.\\n\",\n \"link\": \"https://feedback.torbox.app/changelog/v20\",\n \"created_at\": \"2023-09-20T22:14:20Z\",\n \"id\": \"650b6b638fd5d499ff2aeeae\"\n },\n {\n \"name\": \"v1.6\",\n \"html\": \"Added allowing files to be added directly to Dropbox from the download page. Only works for single files.
Added allowing files to be added directly to Google Drive from the download page. Only works for single files.
This patch was actually made 9/18/2023
\",\n \"markdown\": \"- Added allowing files to be added directly to Dropbox from the download page. Only works for single files.\\n- Added allowing files to be added directly to Google Drive from the download page. Only works for single files.\\n\\n*This patch was actually made 9/18/2023*\\n\",\n \"link\": \"https://feedback.torbox.app/changelog/v16\",\n \"created_at\": \"2023-09-20T21:59:48Z\",\n \"id\": \"650b6ae28fd5d499ff2a9bf2\"\n },\n {\n \"name\": \"v1.5\",\n \"html\": \"Zipped folders. You can now download entire folders as zips rather than downloading each file separately. This comes at the cost of reduced download speeds as well as no multi-connection downloads
Changed download page design
This patch was actually made 9/16/2023
\",\n \"markdown\": \"- Zipped folders. You can now download entire folders as zips rather than downloading each file separately. This comes at the cost of reduced download speeds as well as no multi-connection downloads\\n- Changed download page design\\n\\n*This patch was actually made 9/16/2023*\\n\",\n \"link\": \"https://feedback.torbox.app/changelog/v15\",\n \"created_at\": \"2023-09-20T21:57:47Z\",\n \"id\": \"650b6a798fd5d499ff2a5ec9\"\n },\n {\n \"name\": \"v1.4.2\",\n \"html\": \"New download page design
This patch was actually made 9/15/2023
\",\n \"markdown\": \"- New download page design\\n\\n*This patch was actually made 9/15/2023*\\n\",\n \"link\": \"https://feedback.torbox.app/changelog/v142\",\n \"created_at\": \"2023-09-20T21:55:59Z\",\n \"id\": \"650b6a458fd5d499ff2a411d\"\n },\n {\n \"name\": \"v1.4.1\",\n \"html\": \"Fixed download page not showing all the downloads
Made torrents actually abide by the expiry date (before torrents weren't being deleted)
This patch was actually made 9/13/2023
\",\n \"markdown\": \"- Fixed download page not showing all the downloads\\n- Made torrents actually abide by the expiry date (before torrents weren't being deleted)\\n\\n*This patch was actually made 9/13/2023*\\n\",\n \"link\": \"https://feedback.torbox.app/changelog/v141\",\n \"created_at\": \"2023-09-20T21:54:56Z\",\n \"id\": \"650b69f08fd5d499ff2a0857\"\n },\n {\n \"name\": \"v1.4\",\n \"html\": \"Added \\\"Download All\\\" buttons (the \\\"Direct Download All\\\" button will open every download in a new tab)
Added \\\"Add All to Jdownload\\\" button (copies all the download links to your clipboard)
Added \\\"Add All to IDM\\\" button
Added speed test site to test the download speeds to each server before hand. Speed Test.
Added some legal pages such as the abuse page. Please be aware that DMCA requests will be accepted but it is very unlikely that I will be able to fulfill any of them. Unless they are court ordered and I am required to give up logs for the download clients, then it is very unlikely that I will be able to even do anything about the DMCA requests. If I can, I will email the user whose account received the DMCA request, and ask them to remove the torrent.
Ratio for torrents is no uncapped. It will seed as much as it can for 24 hours/30 days depending on what plan you are on. The only catch is that the max upload speed per server has been set to 1gbit per second.
This patch was actually made 9/11/2023
\",\n \"markdown\": \"- Added \\\"Download All\\\" buttons (the \\\"Direct Download All\\\" button will open every download in a new tab)\\n- Added \\\"Add All to Jdownload\\\" button (copies all the download links to your clipboard)\\n- Added \\\"Add All to IDM\\\" button\\n- Added speed test site to test the download speeds to each server before hand. [Speed Test.](https://speedtest.torbox.app)\\n- Added some legal pages such as the abuse page. Please be aware that DMCA requests will be accepted *but* it is very unlikely that I will be able to fulfill any of them. Unless they are court ordered and I am required to give up logs for the download clients, then it is very unlikely that I will be able to even do anything about the DMCA requests. If I can, I will email the user whose account received the DMCA request, and ask them to remove the torrent.\\n- **Ratio for torrents is no uncapped. It will seed as much as it can for 24 hours/30 days depending on what plan you are on. **The only catch is that the max upload speed per server has been set to 1gbit per second.\\n\\n*This patch was actually made 9/11/2023*\\n\",\n \"link\": \"https://feedback.torbox.app/changelog/v14\",\n \"created_at\": \"2023-09-20T21:53:38Z\",\n \"id\": \"650b684a8fd5d499ff290855\"\n },\n {\n \"name\": \"v1.3\",\n \"html\": \"Had to rewrite most of the API thanks to the new load that I never expected to happen. After the first wave of users, crashing and errors were so common, that I decided to just rewrite the API, the Relay, and the Satellites. This was the only way as I wrote sloppy code as I never expected TorBox to be this popular and working on a sloppy codebase was taking longer to fix bugs than just rewriting, so I did just that. This also was a big change as it changed how I was storing files. Before, I just zipped the files and stored them to be accessible, which worked out fine, but that cuts the storage space I have to work with in half. Obviously this is not going to work as the only way to keep this service alive is to keep pricing low, which means storing files as efficiently as possible. This update changed that.
Downloads were all wiped due to complete schema change.
Removed Nebula Satellite
Added Quasar Satellite
Torrents are no longer stored as zips. Rather they are stored as their raw files, which allows downloads to be much faster and more efficiently store files.
Allowed 16 connections per IP rather than allowing 8 per download.
Removed torrent file picker, as it introduced too much complexity, and usually was only used to squeeze under the 100gb limit for free and essential users.
Removed email notifications. This will be back later. Currently only notifications on the website are sent.
This patch was actually made on 9/10/2023.
\",\n \"markdown\": \"Had to rewrite most of the API thanks to the new load that I never expected to happen. After the first wave of users, crashing and errors were so common, that I decided to just rewrite the API, the Relay, and the Satellites. This was the only way as I wrote sloppy code as I never expected TorBox to be this popular and working on a sloppy codebase was taking longer to fix bugs than just rewriting, so I did just that. This also was a big change as it changed how I was storing files. Before, I just zipped the files and stored them to be accessible, which worked out fine, but that cuts the storage space I have to work with in half. Obviously this is not going to work as the only way to keep this service alive is to keep pricing low, which means storing files as efficiently as possible. This update changed that.\\n- Downloads were all wiped due to complete schema change.\\n- Removed Nebula Satellite\\n- Added Quasar Satellite\\n- Torrents are no longer stored as zips. Rather they are stored as their raw files, which allows downloads to be much faster and more efficiently store files.\\n- Allowed 16 connections per IP rather than allowing 8 per download.\\n- Removed torrent file picker, as it introduced too much complexity, and usually was only used to squeeze under the 100gb limit for free and essential users.\\n- Removed email notifications. This will be back later. Currently only notifications on the website are sent.\\n\\n*This patch was actually made on 9/10/2023.*\\n\",\n \"link\": \"https://feedback.torbox.app/changelog/v13\",\n \"created_at\": \"2023-09-20T21:45:17Z\",\n \"id\": \"650b66478fd5d499ff27d6a7\"\n },\n {\n \"name\": \"v1.2\",\n \"html\": \"Added PayPal payments
Added referral codes for account bonuses
This patch was actually made 9/4/2023
\",\n \"markdown\": \"- Added PayPal payments\\n- Added referral codes for account bonuses\\n\\n*This patch was actually made 9/4/2023*\\n\",\n \"link\": \"https://feedback.torbox.app/changelog/v12-2\",\n \"created_at\": \"2023-09-20T21:36:42Z\",\n \"id\": \"650b65a48fd5d499ff277396\"\n },\n {\n \"name\": \"v1.1.1\",\n \"html\": \"Magnet downloads are fixed
This patch was actually made 9/3/2023
\",\n \"markdown\": \"- Magnet downloads are fixed\\n\\n*This patch was actually made 9/3/2023*\\n\",\n \"link\": \"https://feedback.torbox.app/changelog/v111\",\n \"created_at\": \"2023-09-20T21:35:24Z\",\n \"id\": \"650b65628fd5d499ff27520c\"\n },\n {\n \"name\": \"v1.1\",\n \"html\": \"This is everything that has changed since the v1.0 launch on Discord to a few servers. Likely a lot of people saw v1.0 and it was very buggy and the API ended up crashing for about 6 hours while I was sleeping.
Downloads were made more reliable
Adding torrents were made more reliable
UI updates for torrents were made more reliable
Downloads are now able to be downloaded using download managers, with up to 8 connections per download
Download sizes are more reliable (some people were seeing 20gb downloaded on a 12gb file)
Connecting to your server: \\\"Connected to _____ Satellite\\\" should be much faster
Cached torrents are added properly
Cached torrents are deleted properly (no more seeing \\\"Finished\\\" but not seeing \\\"Download Ready\\\"
Torrents files are added properly
About page has current stats rather than hard-coded ones
This patch was actually made on 9/2/2023
\",\n \"markdown\": \"This is everything that has changed since the v1.0 launch on Discord to a few servers. Likely a lot of people saw v1.0 and it was very buggy and the API ended up crashing for about 6 hours while I was sleeping. \\n- Downloads were made more reliable\\n- Adding torrents were made more reliable\\n- UI updates for torrents were made more reliable\\n- Downloads are now able to be downloaded using download managers, with up to 8 connections per download\\n- Download sizes are more reliable (some people were seeing 20gb downloaded on a 12gb file)\\n- Connecting to your server: \\\"Connected to \\\\_\\\\_\\\\_\\\\_\\\\_ Satellite\\\" should be much faster\\n- Cached torrents are added properly\\n- Cached torrents are deleted properly (no more seeing \\\"Finished\\\" but not seeing \\\"Download Ready\\\"\\n- Torrents files are added properly\\n- About page has current stats rather than hard-coded ones\\n\\n*This patch was actually made on 9/2/2023*\\n\",\n \"link\": \"https://feedback.torbox.app/changelog/v11\",\n \"created_at\": \"2023-09-20T21:34:19Z\",\n \"id\": \"650b64368fd5d499ff26ced4\"\n }\n ]\n}"},{"id":"05d82ed9-e91e-4d7f-a5a7-e3bac7e3bfe3","name":"Fail DATABASE_ERROR","originalRequest":{"method":"GET","header":[],"url":"{{api_base}}/{{api_version}}/api/changelogs/json"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"DATABASE_ERROR\",\n \"detail\": \"There was an error getting the changelogs. Please try again later.\",\n \"data\": null\n}"},{"id":"b14a5f28-0d81-4b97-86f8-9e3b501e88b2","name":"Fail UNKNOWN_ERROR","originalRequest":{"method":"GET","header":[],"url":"{{api_base}}/{{api_version}}/api/changelogs/json"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"UNKNOWN_ERROR\",\n \"detail\": \"There was an error getting the JSON changelogs. Please try again later.\",\n \"data\": null\n}"}],"_postman_id":"93e8360e-5050-4fd8-aec8-412ead2d5392"},{"name":"Get Speedtest Files","id":"ac283d81-53d8-414c-9f53-01c8552bb9e7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{api_base}}/{{api_version}}/api/speedtest?test_length=short®ion=&user_ip=","description":"Overview
\nGets CDN speedtest files. This can be used for speedtesting TorBox for users or other usages, such as checking download speeds for verification. Provides all necessary data such as region, server name, and even coordinates. Uses the requesting IP to determine if the server is the closest to the user.
\nYou also have the ability to choose between long tests or short tests via the \"test_length\" parameter. You may also force the region selection by passing the \"region\" as a specific region.
\nAuthorization
\nNone needed.
\n","auth":{"type":"bearer","bearer":{"token":"{{api_key}}"},"isInherited":true,"source":{"_postman_id":"4244cdaf-ece6-4b6d-a2ca-463a3af48f54","id":"4244cdaf-ece6-4b6d-a2ca-463a3af48f54","name":"Main API","type":"collection"}},"urlObject":{"path":["{{api_version}}","api","speedtest"],"host":["{{api_base}}"],"query":[{"description":{"content":"Determines the size of the file used for the speedtest. May be \"long\" or \"short\". Optional.
\n","type":"text/plain"},"key":"test_length","value":"short"},{"description":{"content":"Determines what cdns are returned. May be any region that TorBox is located in. To get this value, send a request without this value to determine all of the available regions that are available.
\n","type":"text/plain"},"key":"region","value":""},{"description":{"content":"Pass a user's IP to get the closest server to them, otherwise will use the calling IP for location.
\n","type":"text/plain"},"key":"user_ip","value":""}],"variable":[]}},"response":[{"id":"aeff4d4d-f9bb-4c51-afdf-a714e7e64609","name":"Success","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{api_base}}/{{api_version}}/api/speedtest?test_length=long®ion=string","host":["{{api_base}}"],"path":["{{api_version}}","api","speedtest"],"query":[{"key":"test_length","value":"long","description":"Determines the size of the file used for the speedtest. May be \"long\" or \"short\". Optional."},{"key":"region","value":"string","description":"Determines what cdns are returned. May be any region that TorBox is located in. To get this value, send a request without this value to determine all of the available regions that are available."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"detail\": \"Successfully retrieved test files for speed test.\",\n \"error\": null,\n \"data\": [\n {\n \"region\": \"string\",\n \"name\": \"string\",\n \"domain\": \"https://XXX\",\n \"path\": \"string\",\n \"url\": \"https://XXX\",\n \"closest\": true,\n \"coordinates\": {\n \"lat\": 52.374,\n \"lng\": 4.8897\n }\n }\n ]\n}"},{"id":"6333ffe5-17d0-4239-9a11-0bbbe1e4dead","name":"Fail ITEM_NOT_FOUND","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{api_base}}/{{api_version}}/api/speedtest?test_length=short®ion=&user_ip=","host":["{{api_base}}"],"path":["{{api_version}}","api","speedtest"],"query":[{"key":"test_length","value":"short","description":"Determines the size of the file used for the speedtest. May be \"long\" or \"short\". Optional."},{"key":"region","value":"","description":"Determines what cdns are returned. May be any region that TorBox is located in. To get this value, send a request without this value to determine all of the available regions that are available."},{"key":"user_ip","value":"","description":"Pass a user's IP to get the closest server to them, otherwise will use the calling IP for location."}]}},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"detail\": \"No test files for speed testing could be found. Please try again later.\",\n \"error\": \"ITEM_NOT_FOUND\",\n \"data\": []\n}"}],"_postman_id":"ac283d81-53d8-414c-9f53-01c8552bb9e7"}],"id":"49bd8f5e-891f-46ae-bc52-863cbce87b64","description":"Overview
\nThese are the general endpoints for TorBox. They aren't mission critical, but if your app or service needs them, they are here.
\nAuthorization
\nNone needed.
\nEndpoints
\n- \n
\nGETGet Up Status/\n
\nGETGet Stats/stats\n
\nGETGet Changelogs RSS Feed/changelogs/rss\n
\nGETGet Changelogs JSON/changelogs/json\n
\nGETGet Speedtest Files/speedtest\n
Overview
\nGets your notifications in an RSS Feed which allows you to use them with RSS Feed readers or notification services that can take RSS Feeds and listen to updates. As soon as a notification goes to your account, it will be added to your feed.
\nAuthorization
\nRequires an API key using as a query parameter using the token key.
The user's API key.
\n","type":"text/plain"},"key":"token","value":""}],"variable":[]}},"response":[{"id":"47acc63b-172c-490d-971e-2db61457763f","name":"Success","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{api_base}}/{{api_version}}/api/notifications/rss?token=","host":["{{api_base}}"],"path":["{{api_version}}","api","notifications","rss"],"query":[{"key":"token","value":"","description":"The User's API token"}]}},"status":"OK","code":200,"_postman_previewlanguage":"xml","header":[{"key":"date","value":"Thu, 16 Nov 2023 02:25:20 GMT"},{"key":"server","value":"uvicorn"},{"key":"content-length","value":"1410"},{"key":"content-type","value":"application/xml"}],"cookie":[],"responseTime":null,"body":"\nOverview
\nGets your notifications in a JSON object that is easily parsable compared to the RSS Feed. Gives all the same data as the RSS Feed.
\nAuthorization
\nRequires an API key using the Authorization Bearer Header.
\n","urlObject":{"path":["{{api_version}}","api","notifications","mynotifications"],"host":["{{api_base}}"],"query":[],"variable":[]}},"response":[{"id":"18ad919b-ced6-4205-b25d-eea437235675","name":"Success","originalRequest":{"method":"GET","header":[],"url":"{{api_base}}/{{api_version}}/api/notifications/mynotifications"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"date","value":"Sat, 23 Dec 2023 03:01:13 GMT"},{"key":"server","value":"uvicorn"},{"key":"content-length","value":"2586"},{"key":"content-type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"error\": null,\n \"detail\": \"Successfully retrieved your notifications.\",\n \"data\": [\n {\n \"id\": 0,\n \"created_at\": \"2023-12-22T22:39:22.387095+00:00\",\n \"title\": \"Test\",\n \"message\": \"This is a test.\",\n \"auth_id\": \"XXXXXXXXXXXXXXXXXXXXXXXX\"\n },\n {\n \"id\": 1,\n \"created_at\": \"2023-12-22T22:39:23.540178+00:00\",\n \"title\": \"Test\",\n \"message\": \"This is a test.\",\n \"auth_id\": \"XXXXXXXXXXXXXXXXXXXXXXXX\"\n }\n ]\n}"},{"id":"ed0c848c-658e-45f3-aeb9-6584587ebf1d","name":"Fail BAD_TOKEN","originalRequest":{"method":"GET","header":[],"url":"{{api_base}}/{{api_version}}/api/notifications/mynotifications"},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"BAD_TOKEN\",\n \"detail\": \"Your token is invalid or has expired. Please log in again or reset your token.\",\n \"data\": null\n}"},{"id":"49aa3e8d-23cb-4a65-8ecf-26828ac2e7d1","name":"Fail NO_AUTH","originalRequest":{"method":"GET","header":[],"url":"{{api_base}}/{{api_version}}/api/notifications/mynotifications"},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"detail\": \"Please provide a valid API token.\",\n \"error\": \"NO_AUTH\",\n \"data\": null\n}"},{"id":"2842cf12-310f-4f0b-b9f6-e179ed24995f","name":"Fail AUTH_ERROR","originalRequest":{"method":"GET","header":[],"url":"{{api_base}}/{{api_version}}/api/notifications/mynotifications"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"AUTH_ERROR\",\n \"detail\": \"There was an error verifying your API key. Please try again later.\",\n \"data\": null\n}"},{"id":"ae770dbf-bd54-4fae-87ca-1d75667f25db","name":"Fail UNKNOWN_ERROR","originalRequest":{"method":"GET","header":[],"url":"{{api_base}}/{{api_version}}/api/notifications/mynotifications"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"UNKNOWN_ERROR\",\n \"detail\": \"There was an error getting your notifications. Please try again later.\",\n \"data\": null\n}"}],"_postman_id":"5ba21bea-2f21-466d-90cb-29337e772eca"},{"name":"Clear All Notifications","id":"8260688c-f430-42f4-988c-b02d7fd79dc5","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"url":"{{api_base}}/{{api_version}}/api/notifications/clear","description":"Overview
\nMarks all of your notifications as read and deletes them permanently.
\nAuthorization
\nRequires an API key using the Authorization Bearer Header.
\n","auth":{"type":"bearer","bearer":{"token":"{{api_key}}"},"isInherited":true,"source":{"_postman_id":"4244cdaf-ece6-4b6d-a2ca-463a3af48f54","id":"4244cdaf-ece6-4b6d-a2ca-463a3af48f54","name":"Main API","type":"collection"}},"urlObject":{"path":["{{api_version}}","api","notifications","clear"],"host":["{{api_base}}"],"query":[],"variable":[]}},"response":[{"id":"31f2ad48-2ad1-4ed5-b703-8112d96c5f58","name":"Success","originalRequest":{"method":"POST","header":[],"url":"{{api_base}}/{{api_version}}/api/notifications/clear"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"error\": null,\n \"detail\": \"Successfully cleared your notifications.\",\n \"data\": null\n}"},{"id":"1efdeafb-6482-4cde-9a7a-742c9cf1642a","name":"Fail UNKNOWN_ERROR","originalRequest":{"method":"POST","header":[],"url":"{{api_base}}/{{api_version}}/api/notifications/clear"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"UNKNOWN_ERROR\",\n \"detail\": \"There was an error clearing your notifications. Please try again later.\",\n \"data\": null\n}"},{"id":"4eeda620-f63c-4677-85cc-183b8af038b4","name":"Fail DATABASE_ERROR","originalRequest":{"method":"POST","header":[],"url":"{{api_base}}/{{api_version}}/api/notifications/clear"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"DATABASE_ERROR\",\n \"detail\": \"There was an error clearing your notifications. Please try again later.\",\n \"data\": null\n}"},{"id":"b45c90bd-bf44-4863-b470-1cbf9b989aae","name":"Fail AUTH_ERROR","originalRequest":{"method":"POST","header":[],"url":"{{api_base}}/{{api_version}}/api/notifications/clear"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"AUTH_ERROR\",\n \"detail\": \"There was an error verifying your API key. Please try again later.\",\n \"data\": null\n}"},{"id":"b15dbe2b-9ca3-4bb4-a1a2-451d4b959ed9","name":"Fail NO_AUTH","originalRequest":{"method":"POST","header":[],"url":"{{api_base}}/{{api_version}}/api/notifications/clear"},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"detail\": \"Please provide a valid API token.\",\n \"error\": \"NO_AUTH\",\n \"data\": null\n}"},{"id":"810d0b14-cd62-48c4-8e46-cdb732edd5c7","name":"Fail BAD_TOKEN","originalRequest":{"method":"POST","header":[],"url":"{{api_base}}/{{api_version}}/api/notifications/clear"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"BAD_TOKEN\",\n \"detail\": \"Your token is invalid or has expired. Please log in again or reset your token.\",\n \"data\": null\n}"}],"_postman_id":"8260688c-f430-42f4-988c-b02d7fd79dc5"},{"name":"Clear Single Notification","id":"699d4381-3a3b-4979-9ec9-99cfb23ff038","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"url":"{{api_base}}/{{api_version}}/api/notifications/clear/{{notification_id}}","description":"Overview
\nMarks a single notification as read and permanently deletes it from your notifications. Requires a notification_id which can be found by getting your notification feed.
Authorization
\nRequires an API key using the Authorization Bearer Header.
\n","auth":{"type":"bearer","bearer":{"token":"{{api_key}}"},"isInherited":true,"source":{"_postman_id":"4244cdaf-ece6-4b6d-a2ca-463a3af48f54","id":"4244cdaf-ece6-4b6d-a2ca-463a3af48f54","name":"Main API","type":"collection"}},"urlObject":{"path":["{{api_version}}","api","notifications","clear","{{notification_id}}"],"host":["{{api_base}}"],"query":[],"variable":[]}},"response":[{"id":"8b6000df-4fa0-49c8-9121-a6c58e97d2e4","name":"Success","originalRequest":{"method":"POST","header":[],"url":"{{api_base}}/{{api_version}}/api/notifications/clear/id"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"error\": null,\n \"detail\": \"Successfully cleared your notification.\",\n \"data\": null\n}"},{"id":"e9660432-d658-49b1-9036-c485843524a8","name":"Fail DATABASE_ERROR","originalRequest":{"method":"POST","header":[],"url":"{{api_base}}/{{api_version}}/api/notifications/clear/id"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"DATABASE_ERROR\",\n \"detail\": \"There was an error clearing your notification. Please try again later.\",\n \"data\": null,\n}"},{"id":"97f15f34-e4a7-49c2-ba83-facc51979104","name":"Fail UNKNOWN_ERROR","originalRequest":{"method":"POST","header":[],"url":"{{api_base}}/{{api_version}}/api/notifications/clear/id"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"UNKNOWN_ERROR\",\n \"detail\": \"There was an error clearing your notification. Please try again later.\",\n \"data\": null\n}"},{"id":"718e26ea-a99a-46b3-814e-243989fc9cfb","name":"Fail AUTH_ERROR","originalRequest":{"method":"POST","header":[],"url":"{{api_base}}/{{api_version}}/api/notifications/clear/id"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"AUTH_ERROR\",\n \"detail\": \"There was an error verifying your API key. Please try again later.\",\n \"data\": null\n}"},{"id":"3a271205-60ba-42b5-9660-21c3597d47b6","name":"Fail NO_AUTH","originalRequest":{"method":"POST","header":[],"url":"{{api_base}}/{{api_version}}/api/notifications/clear/id"},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"detail\": \"Please provide a valid API token.\",\n \"error\": \"NO_AUTH\",\n \"data\": null\n}"},{"id":"cebd5840-3e6e-4af8-8bda-ad41a78927e5","name":"Fail BAD_TOKEN","originalRequest":{"method":"POST","header":[],"url":"{{api_base}}/{{api_version}}/api/notifications/clear/id"},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"BAD_TOKEN\",\n \"detail\": \"Your token is invalid or has expired. Please log in again or reset your token.\",\n \"data\": null\n}"}],"_postman_id":"699d4381-3a3b-4979-9ec9-99cfb23ff038"},{"name":"Send Test Notification","id":"03709e2d-4c17-49cb-bcac-bf9c1c99c536","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"url":"{{api_base}}/{{api_version}}/api/notifications/test","description":"Overview
\nSends a test notification to all enabled notification types. This can be useful for validating setups. No need for any body in this request.
\nAuthorization
\nRequires an API key using the Authorization Bearer Header.
\n","auth":{"type":"bearer","bearer":{"token":"{{api_key}}"},"isInherited":true,"source":{"_postman_id":"4244cdaf-ece6-4b6d-a2ca-463a3af48f54","id":"4244cdaf-ece6-4b6d-a2ca-463a3af48f54","name":"Main API","type":"collection"}},"urlObject":{"path":["{{api_version}}","api","notifications","test"],"host":["{{api_base}}"],"query":[],"variable":[]}},"response":[{"id":"05e29fb5-d0db-446a-a1ce-45f1ffb533ef","name":"Success","originalRequest":{"method":"POST","header":[],"url":"{{api_base}}/{{api_version}}/api/notifications/test"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"error\": null,\n \"detail\": \"Successfully sent your test notification.\",\n \"data\": null\n}"},{"id":"92df8043-99d9-402c-844f-ae587bd8bfe3","name":"Fail DATABASE_ERROR","originalRequest":{"method":"POST","header":[],"url":"{{api_base}}/{{api_version}}/api/notifications/test"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"DATABASE_ERROR\",\n \"detail\": \"There was an error sending your test notification. Please try again later.\",\n \"data\": null\n}"},{"id":"e508deac-4ad4-40b7-9645-d5f6d60eedd6","name":"Fail AUTH_ERROR","originalRequest":{"method":"POST","header":[],"url":"{{api_base}}/{{api_version}}/api/notifications/test"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"AUTH_ERROR\",\n \"detail\": \"There was an error verifying your API key. Please try again later.\",\n \"data\": null\n}"},{"id":"014658c3-76fa-4a16-b07d-0063ccf5027d","name":"Fail UNKNOWN_ERROR","originalRequest":{"method":"POST","header":[],"url":"{{api_base}}/{{api_version}}/api/notifications/test"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"UNKNOWN_ERROR\",\n \"detail\": \"There was an error sending your test notification. Please try again later.\",\n \"data\": null\n}"},{"id":"56faa28c-0c03-407a-94a1-d5786b0278f3","name":"Fail NO_AUTH","originalRequest":{"method":"POST","header":[],"url":"{{api_base}}/{{api_version}}/api/notifications/test"},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"detail\": \"Please provide a valid API token.\",\n \"error\": \"NO_AUTH\",\n \"data\": null\n}"},{"id":"7c29060c-f192-4071-8a3e-12202edceb8d","name":"Fail BAD_TOKEN","originalRequest":{"method":"POST","header":[],"url":"{{api_base}}/{{api_version}}/api/notifications/test"},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"BAD_TOKEN\",\n \"detail\": \"Your token is invalid or has expired. Please log in again or reset your token.\",\n \"data\": null\n}"}],"_postman_id":"03709e2d-4c17-49cb-bcac-bf9c1c99c536"}],"id":"4ad6d564-44d5-4138-a396-91e4a4522dde","description":"Overview
\nNotifications are important for TorBox to always know what is happening with your account or your torrents. This route allows your to get and view your notifications.
\nAuthorization
\nFor all requests, you will need your API token which can be found on your TorBox settings page under the API key section. Simply copy or refresh the API token and use it in the API.
\nEndpoints /api/notifications
\n- \n
\nGETGet RSS Notification Feed/rss\n
\nGETGet User's Notification Feed/mynotifications\n
\nPOSTClear All Notifications/clear\n
\nPOSTClear Single Notification/clear/{id}\n
\nPOSTSend Test Notification/test\n
Overview
\nIf you want a new API token, or your old one has been compromised, you may request a new one. If you happen to forget the token, go the TorBox settings page and copy the current one. If this still doesn't work, you may contact us at our support email for a new one.
\nAuthorization
\nRequires an API key using the Authorization Bearer Header as well as passing the session_token from the website to be passed in the body. You can find the session_token in the localStorage of your browser on any TorBox.app page under the key torbox_session_token. This is a temporary token that only lasts for 1 hour, which is why it is used here to verify the identity of a user as well as their API token.
Overview
\nGets a users account data and information.
\nPlans
\n0 is Free plan
1 is Essential plan ($3 plan)
2 is Pro plan ($10 plan)
3 is Standard plan ($5 plan)
Authorization
\nRequires an API key using the Authorization Bearer Header.
\n","urlObject":{"path":["{{api_version}}","api","user","me"],"host":["{{api_base}}"],"query":[{"description":{"content":"Allows you to retrieve user settings.
\n","type":"text/plain"},"key":"settings","value":"false"}],"variable":[]}},"response":[{"id":"a07d72a7-4d1e-4473-93e9-7ce39548bb60","name":"Success","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{api_base}}/{{api_version}}/api/user/me?settings=false","host":["{{api_base}}"],"path":["{{api_version}}","api","user","me"],"query":[{"key":"settings","value":"false","description":"Allows you to retrieve user settings."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"date","value":"Sat, 23 Dec 2023 02:41:18 GMT"},{"key":"server","value":"uvicorn"},{"key":"content-length","value":"529"},{"key":"content-type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n\t\"success\": true,\n\t\"error\": null,\n\t\"detail\": \"Successfully retrieved your user information.\",\n\t\"data\": {\n\t\t\"id\": 0,\n\t\t\"auth_id\": \"string\",\n\t\t\"created_at\": \"2023-08-30T20:23:00Z\",\n\t\t\"updated_at\": \"2026-03-09T00:22:40Z\",\n\t\t\"plan\": 0,\n\t\t\"total_downloaded\": 0,\n\t\t\"customer\": \"string\",\n\t\t\"is_subscribed\": true,\n\t\t\"premium_expires_at\": \"2051-02-18T04:08:43Z\",\n\t\t\"cooldown_until\": \"2026-03-10T00:22:40Z\",\n\t\t\"email\": \"example@example.com\",\n\t\t\"user_referral\": \"string\",\n\t\t\"base_email\": \"example@example.com\",\n\t\t\"total_bytes_downloaded\": 0,\n\t\t\"total_bytes_uploaded\": 0,\n\t\t\"torrents_downloaded\": 0,\n\t\t\"web_downloads_downloaded\": 0,\n\t\t\"usenet_downloads_downloaded\": 0,\n\t\t\"additional_concurrent_slots\": 0,\n\t\t\"long_term_seeding\": false,\n\t\t\"long_term_storage\": false,\n\t\t\"is_vendor\": false,\n\t\t\"vendor_id\": 0,\n\t\t\"purchases_referred\": 0\n\t}\n}"},{"id":"3aba169f-23fc-48c6-927a-b1e9289a8b10","name":"Success SETTINGS","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{api_base}}/{{api_version}}/api/user/me?settings=true","host":["{{api_base}}"],"path":["{{api_version}}","api","user","me"],"query":[{"key":"settings","value":"true","description":"Allows you to retrieve user settings."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"date","value":"Sat, 23 Dec 2023 02:41:18 GMT"},{"key":"server","value":"uvicorn"},{"key":"content-length","value":"529"},{"key":"content-type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n\t\"success\": true,\n\t\"error\": null,\n\t\"detail\": \"Successfully retrieved your user information.\",\n\t\"data\": {\n\t\t\"id\": 0,\n\t\t\"auth_id\": \"string\",\n\t\t\"created_at\": \"2023-08-30T20:23:00Z\",\n\t\t\"updated_at\": \"2026-03-09T00:22:40Z\",\n\t\t\"plan\": 0,\n\t\t\"total_downloaded\": 0,\n\t\t\"customer\": \"string\",\n\t\t\"is_subscribed\": true,\n\t\t\"premium_expires_at\": \"2051-02-18T04:08:43Z\",\n\t\t\"cooldown_until\": \"2026-03-10T00:22:40Z\",\n\t\t\"email\": \"example@example.com\",\n\t\t\"user_referral\": \"string\",\n\t\t\"base_email\": \"example@example.com\",\n\t\t\"total_bytes_downloaded\": 0,\n\t\t\"total_bytes_uploaded\": 0,\n\t\t\"torrents_downloaded\": 0,\n\t\t\"web_downloads_downloaded\": 0,\n\t\t\"usenet_downloads_downloaded\": 0,\n\t\t\"additional_concurrent_slots\": 0,\n\t\t\"long_term_seeding\": false,\n\t\t\"long_term_storage\": false,\n\t\t\"is_vendor\": true,\n\t\t\"vendor_id\": 0,\n\t\t\"purchases_referred\": 0,\n\t\t\"settings\": {\n\t\t\t\"email_notifications\": false,\n\t\t\t\"web_notifications\": true,\n\t\t\t\"mobile_notifications\": true,\n\t\t\t\"rss_notifications\": true,\n\t\t\t\"download_speed_in_tab\": false,\n\t\t\t\"show_tracker_in_torrent\": false,\n\t\t\t\"stremio_quality\": [\n\t\t\t\t0,\n\t\t\t\t1,\n\t\t\t\t2,\n\t\t\t\t3,\n\t\t\t\t4,\n\t\t\t\t5,\n\t\t\t\t6,\n\t\t\t\t7,\n\t\t\t\t8,\n\t\t\t\t9,\n\t\t\t\t10,\n\t\t\t\t11\n\t\t\t],\n\t\t\t\"stremio_resolution\": [\n\t\t\t\t0,\n\t\t\t\t1,\n\t\t\t\t2,\n\t\t\t\t3\n\t\t\t],\n\t\t\t\"stremio_language\": [\n\t\t\t\t0,\n\t\t\t\t1,\n\t\t\t\t2,\n\t\t\t\t3,\n\t\t\t\t4,\n\t\t\t\t5,\n\t\t\t\t6,\n\t\t\t\t7,\n\t\t\t\t8,\n\t\t\t\t9,\n\t\t\t\t10,\n\t\t\t\t11,\n\t\t\t\t12,\n\t\t\t\t13,\n\t\t\t\t14,\n\t\t\t\t15,\n\t\t\t\t16,\n\t\t\t\t17,\n\t\t\t\t18,\n\t\t\t\t19,\n\t\t\t\t20,\n\t\t\t\t21\n\t\t\t],\n\t\t\t\"stremio_cache\": [\n\t\t\t\t1\n\t\t\t],\n\t\t\t\"stremio_size_lower\": 0,\n\t\t\t\"google_drive_folder_id\": \"string\",\n\t\t\t\"onedrive_save_path\": \"string\",\n\t\t\t\"discord_id\": \"string\",\n\t\t\t\"discord_notifications\": true,\n\t\t\t\"stremio_allow_adult\": false,\n\t\t\t\"stremio_seed_torrents\": 3,\n\t\t\t\"seed_torrents\": 1,\n\t\t\t\"allow_zipped\": true,\n\t\t\t\"stremio_allow_zipped\": false,\n\t\t\t\"onefichier_folder_id\": \"string\",\n\t\t\t\"gofile_folder_id\": \"string\",\n\t\t\t\"jdownloader_notifications\": true,\n\t\t\t\"webhook_notifications\": false,\n\t\t\t\"webhook_url\": \"string\",\n\t\t\t\"telegram_notifications\": true,\n\t\t\t\"telegram_id\": \"string\",\n\t\t\t\"mega_email\": \"string\",\n\t\t\t\"mega_password\": \"string\",\n\t\t\t\"stremio_sort\": \"string\",\n\t\t\t\"cdn_selection\": \"string\",\n\t\t\t\"stremio_use_custom_search_engines\": \"string\",\n\t\t\t\"stremio_result_sort\": \"string\",\n\t\t\t\"webdav_use_local_files\": false,\n\t\t\t\"stremio_legacy_your_media\": false,\n\t\t\t\"stremio_only_your_media_streams\": false,\n\t\t\t\"stremio_disable_your_media_streams\": true,\n\t\t\t\"webdav_use_folder_view\": false,\n\t\t\t\"webdav_flatten\": false,\n\t\t\t\"stremio_limit_per_resolution_torrent\": 0,\n\t\t\t\"stremio_limit_per_resolution_usenet\": 0,\n\t\t\t\"stremio_size_upper\": 0,\n\t\t\t\"stremio_torrent_seeders_cutoff\": 0,\n\t\t\t\"pixeldrain_api_key\": \"string\",\n\t\t\t\"onefichier_api_key\": \"string\",\n\t\t\t\"gofile_api_key\": \"string\",\n\t\t\t\"patreon_id\": \"string\",\n\t\t\t\"stremio_wait_for_download_usenet\": true,\n\t\t\t\"stremio_wait_for_download_torrent\": false,\n\t\t\t\"stremio_disable_filtered_note\": false,\n\t\t\t\"stremio_emoji_in_description\": false,\n\t\t\t\"dashboard_filter\": {\n\t\t\t\t\"active\": false,\n\t\t\t\t\"cached\": false,\n\t\t\t\t\"queued\": false,\n\t\t\t\t\"private\": false,\n\t\t\t\t\"borrowed\": false,\n\t\t\t\t\"inactive\": false,\n\t\t\t\t\"torrents\": false,\n\t\t\t\t\"uncached\": false,\n\t\t\t\t\"uploading\": false,\n\t\t\t\t\"processing\": false,\n\t\t\t\t\"downloading\": false,\n\t\t\t\t\"web_downloads\": false,\n\t\t\t\t\"download_ready\": false,\n\t\t\t\t\"usenet_downloads\": false\n\t\t\t},\n\t\t\t\"web_player_always_transcode\": true,\n\t\t\t\"web_player_always_skip_intro\": false,\n\t\t\t\"web_player_audio_preferred_language\": \"string\",\n\t\t\t\"web_player_subtitle_preferred_language\": \"string\",\n\t\t\t\"web_player_disable_prestream_selector\": false,\n\t\t\t\"dashboard_sort\": \"string\",\n\t\t\t\"web_player_disable_next_up_dialogue\": false,\n\t\t\t\"web_player_enable_scrobbling\": false,\n\t\t\t\"append_filename_to_links\": true\n\t\t}\n\t}\n}"},{"id":"dc2ada96-93c3-492f-89a6-3882830c0155","name":"Fail AUTH_ERROR","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{api_base}}/{{api_version}}/api/user/me?settings=false","host":["{{api_base}}"],"path":["{{api_version}}","api","user","me"],"query":[{"key":"settings","value":"false","description":"Allows you to retrieve user settings."}]}},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"AUTH_ERROR\",\n \"detail\": \"There was an error verifying your API key. Please try again later.\",\n \"data\": null\n}"},{"id":"cbba9274-0c30-47f1-adc0-21c2ee0783a0","name":"Fail DATABASE_ERROR","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{api_base}}/{{api_version}}/api/user/me?settings=false","host":["{{api_base}}"],"path":["{{api_version}}","api","user","me"],"query":[{"key":"settings","value":"false","description":"Allows you to retrieve user settings."}]}},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"DATABASE_ERROR\",\n \"detail\": \"There was an error processing your request. Please try again later.\",\n \"data\": null\n}"},{"id":"89e446ea-714c-4856-9b33-e10bdf4a206c","name":"Fail UNKNOWN_ERROR","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{api_base}}/{{api_version}}/api/user/me?settings=false","host":["{{api_base}}"],"path":["{{api_version}}","api","user","me"],"query":[{"key":"settings","value":"false","description":"Allows you to retrieve user settings."}]}},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"UNKNOWN_ERROR\",\n \"detail\": \"There was an error retrieving your user information. Please try again later.\",\n \"data\": null\n}"},{"id":"1b76f0c7-b6da-48dc-a6b0-cefdcf5be50b","name":"Fail NO_AUTH","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{api_base}}/{{api_version}}/api/user/me?settings=false","host":["{{api_base}}"],"path":["{{api_version}}","api","user","me"],"query":[{"key":"settings","value":"false","description":"Allows you to retrieve user settings."}]}},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"detail\": \"Please provide a valid API token.\",\n \"error\": \"NO_AUTH\",\n \"data\": null\n}"},{"id":"c0d58c97-f14a-4a98-a1ac-08fbe6468a7a","name":"Fail BAD_TOKEN","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{api_base}}/{{api_version}}/api/user/me?settings=false","host":["{{api_base}}"],"path":["{{api_version}}","api","user","me"],"query":[{"key":"settings","value":"false","description":"Allows you to retrieve user settings."}]}},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"BAD_TOKEN\",\n \"detail\": \"Your token is invalid or has expired. Please log in again or reset your token.\",\n \"data\": null\n}"}],"_postman_id":"a3775d9b-f3ee-49cd-98a4-fc909ed2923b"},{"name":"Add Referral To Account","id":"703cd861-908a-4021-b682-9414f581c9fa","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"url":"{{api_base}}/{{api_version}}/api/user/addreferral?referral=","description":"Overview
\nAutomatically adds a referral code to the user's account. This can be used for developers to automatically add their referral to user's accounts who use their service.
\nThis will not override any referral a user already has. If they already have one, then it cannot be changed using this endpoint. It can only be done by the user on the website.
\nAuthorization
\nRequires an API key using the Authorization Bearer Header. Use the user's API key, not your own.
\n","auth":{"type":"bearer","bearer":{"token":"{{api_key}}"},"isInherited":true,"source":{"_postman_id":"4244cdaf-ece6-4b6d-a2ca-463a3af48f54","id":"4244cdaf-ece6-4b6d-a2ca-463a3af48f54","name":"Main API","type":"collection"}},"urlObject":{"path":["{{api_version}}","api","user","addreferral"],"host":["{{api_base}}"],"query":[{"description":{"content":"A referral code. Must be UUID.
\n","type":"text/plain"},"key":"referral","value":""}],"variable":[]}},"response":[{"id":"c0be0348-2386-4a09-ab68-174296438648","name":"Success","originalRequest":{"method":"POST","header":[],"url":{"raw":"{{api_base}}/{{api_version}}/api/user/addreferral?referral=","host":["{{api_base}}"],"path":["{{api_version}}","api","user","addreferral"],"query":[{"key":"referral","value":"","description":"A referral code. Must be UUID."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"error\": null,\n \"detail\": \"Successfully added referral.\",\n \"data\": null\n}"},{"id":"a3683297-cbb9-4e74-b399-d3b009f49655","name":"Fail BOZO_REFERRAL","originalRequest":{"method":"POST","header":[],"url":{"raw":"{{api_base}}/{{api_version}}/api/user/addreferral?referral=","host":["{{api_base}}"],"path":["{{api_version}}","api","user","addreferral"],"query":[{"key":"referral","value":"","description":"A referral code. Must be UUID."}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"BOZO_REFERRAL\",\n \"detail\": \"This referral code will not give you any benefits as the referrer is on the free plan. Please check and try again.\",\n \"data\": null\n}"},{"id":"b274a154-9376-465b-9a86-c0390673ca0d","name":"Fail WHY_ARE_YOU_LIKE_THIS","originalRequest":{"method":"POST","header":[],"url":{"raw":"{{api_base}}/{{api_version}}/api/user/addreferral?referral=","host":["{{api_base}}"],"path":["{{api_version}}","api","user","addreferral"],"query":[{"key":"referral","value":"","description":"A referral code. Must be UUID."}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"WHY_ARE_YOU_LIKE_THIS\",\n \"detail\": \"You cannot refer yourself.\",\n \"data\": \"Dude awe you actuawwy wike dumb ow something? Wike awe you actuawwy mentawwy chawwenged? Wike if you awe it’s okay but wike pwease teww me if you awe actuawwy being this fucking dumb wight now intentionawwy ow unintentionawwy. Wike awe you actuawwy sub human? Can you not communicate pwopewwy because you awe witewawwy wess evowved than othew peopwe? Wike can you actuawwy not undewstand what I’m saying because you awe so ducking dumb? Awe you witewawwy 67% Neandewthaw? Is that why you’we head is so big and thick? Because youw bwain it witewawwy smawwew than ouws?? Wike is that why you awe so fucking dumb? You know I know peopwe fow that? You can take medications fow that you know, fow being dumb as fuck. I know peopwe who can make you wess of a dumbass you just have to ask me. They can give you medications that wiww make you wess of a fucking idiot. They wiww make you wess subhuman. Maybe you’ww be abwe to get a decent job at Wendy’s ow McDonawds aftew I find you hewp. You don’t have to be supew dumb anymowe, just weawwy dumb. I can hewp you bwo, I can hewp youw sickness just teww me youw fucking dumb and we can stawt thewe. Teww me how stupid and idiotic you awe, yeah just teww me bwo it’s okay I can get you hewp. Teww me how youw mom fucked a monkey and made you wike this, I can hewp you get medications to fix youw fucked up genes bwo. I’m not twying to huwt youw feewings ow wook down on you fow being an un evowved dumbass, I’m just twying to wook out fow you bwo. Idiot monkey guys don’t suwvive wong in the wiwd awound intewwigent humans, that’s why they have gone extinct, and you seem to be the onwy one weft. I can find you an idiot Hawf bweed Neandewthaw wife and you guys can keep youw species going. Bwo I can save youw species just admit to me how fucking stupid and ugwy you awe. They wiww have space fow youw kind in ZOOs, I can hewp you and youw pwehistowic famiwy move into an encwosuwe so you can be safe fow the west of youw wife. I’m twying to save you bwo so pwease. Just teww me you’we stupid. /s\"\n}"},{"id":"5d0f0827-215d-4afa-aa4d-5021832a64a2","name":"Fail AUTH_ERROR","originalRequest":{"method":"POST","header":[],"url":{"raw":"{{api_base}}/{{api_version}}/api/user/addreferral?referral=","host":["{{api_base}}"],"path":["{{api_version}}","api","user","addreferral"],"query":[{"key":"referral","value":"","description":"A referral code. Must be UUID."}]}},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"AUTH_ERROR\",\n \"detail\": \"There was an error verifying your API key. Please try again later.\",\n \"data\": null\n}"},{"id":"968171d4-c0e4-4e74-965a-f34366b119df","name":"Fail UNKNOWN_ERROR","originalRequest":{"method":"POST","header":[],"url":{"raw":"{{api_base}}/{{api_version}}/api/user/addreferral?referral=","host":["{{api_base}}"],"path":["{{api_version}}","api","user","addreferral"],"query":[{"key":"referral","value":"","description":"A referral code. Must be UUID."}]}},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"UNKNOWN_ERROR\",\n \"detail\": \"There was an error adding your referral. Please try again later.\",\n \"data\": null\n}"},{"id":"1c114a05-21fd-4480-a5ec-4339d5d71151","name":"Fail NO_AUTH","originalRequest":{"method":"POST","header":[],"url":{"raw":"{{api_base}}/{{api_version}}/api/user/addreferral?referral=","host":["{{api_base}}"],"path":["{{api_version}}","api","user","addreferral"],"query":[{"key":"referral","value":"","description":"A referral code. Must be UUID."}]}},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"detail\": \"Please provide a valid API token.\",\n \"error\": \"NO_AUTH\",\n \"data\": null\n}"},{"id":"3f4b5395-a4b3-4965-85f6-f97c1ea43b6a","name":"Fail BAD_TOKEN","originalRequest":{"method":"POST","header":[],"url":{"raw":"{{api_base}}/{{api_version}}/api/user/addreferral?referral=","host":["{{api_base}}"],"path":["{{api_version}}","api","user","addreferral"],"query":[{"key":"referral","value":"","description":"A referral code. Must be UUID."}]}},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"BAD_TOKEN\",\n \"detail\": \"Your token is invalid or has expired. Please log in again or reset your token.\",\n \"data\": null\n}"}],"_postman_id":"703cd861-908a-4021-b682-9414f581c9fa"},{"name":"Get Confirmation Code","id":"1c1bfac4-bf2f-4fad-9ae8-a12275be3bd1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{api_base}}/{{api_version}}/api/user/getconfirmation","description":"Overview
\nRequests a 6 digit code to be sent to the user's email for verification. Used to verify a user actually wants to perform a potentially dangerous action.
\nAuthorization
\nRequires an API key using the Authorization Bearer Header.
\n","auth":{"type":"bearer","bearer":{"token":"{{api_key}}"},"isInherited":true,"source":{"_postman_id":"4244cdaf-ece6-4b6d-a2ca-463a3af48f54","id":"4244cdaf-ece6-4b6d-a2ca-463a3af48f54","name":"Main API","type":"collection"}},"urlObject":{"path":["{{api_version}}","api","user","getconfirmation"],"host":["{{api_base}}"],"query":[],"variable":[]}},"response":[{"id":"d69c6d72-16a6-4d2d-ac0d-727571311db2","name":"Success","originalRequest":{"method":"GET","header":[],"url":"{{api_base}}/{{api_version}}/api/user/getconfirmation"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"error\": null,\n \"detail\": \"Successfully sent your confirmation code.\",\n \"data\": null\n}"},{"id":"1cb2f132-6db0-4eb7-a0b4-9e5434131d1c","name":"Fail DATABASE_ERROR","originalRequest":{"method":"GET","header":[],"url":"{{api_base}}/{{api_version}}/api/user/getconfirmation"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"DATABASE_ERROR\",\n \"detail\": \"There was an error sending your confirmation code. Please try again later.\",\n \"data\": null\n}"},{"id":"facb12b3-1f47-488a-927a-0d6f7f8ad333","name":"Fail UNKNOWN_ERROR","originalRequest":{"method":"GET","header":[],"url":"{{api_base}}/{{api_version}}/api/user/getconfirmation"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"UNKNOWN_ERROR\",\n \"detail\": \"There was an error sending your confirmation code. Please try again later.\",\n \"data\": null\n}"},{"id":"ff49c2fa-bc30-48cb-8294-ce391659bef3","name":"Fail AUTH_ERROR","originalRequest":{"method":"GET","header":[],"url":"{{api_base}}/{{api_version}}/api/user/getconfirmation"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"AUTH_ERROR\",\n \"detail\": \"There was an error verifying your API key. Please try again later.\",\n \"data\": null\n}"},{"id":"749f1881-1afe-4d89-a96c-5c9ccda84655","name":"Fail NO_AUTH","originalRequest":{"method":"GET","header":[],"url":"{{api_base}}/{{api_version}}/api/user/getconfirmation"},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"detail\": \"Please provide a valid API token.\",\n \"error\": \"NO_AUTH\",\n \"data\": null\n}"},{"id":"2e6ca452-2fc2-4951-885a-c15aa21f80e7","name":"Fail BAD_TOKEN","originalRequest":{"method":"GET","header":[],"url":"{{api_base}}/{{api_version}}/api/user/getconfirmation"},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"BAD_TOKEN\",\n \"detail\": \"Your token is invalid or has expired. Please log in again or reset your token.\",\n \"data\": null\n}"}],"_postman_id":"1c1bfac4-bf2f-4fad-9ae8-a12275be3bd1"},{"name":"Start Device Code Authorization Process","id":"744bc274-88b7-4faf-a833-e30573c8c1e0","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[],"url":"{{api_base}}/{{api_version}}/api/user/auth/device/start?app=Third Party App","description":"Overview
\nStarts the device code authorization process. Returns all the necessary information to complete the rest of the flow. This includes the following:
\n- \n
\ndevice_code- The code your app will use for consecutive requests for getting the user token. \n
\ncode- This is the 6 digit code that you show to the user to be entered at the following verification_url. \n
\nverification_url- This url which you will show as a QR code. \n
\nfriendly_verification_url- The friendly short url which you can show as plain text to user if they cannot use the QR code method. \n
You may also submit the app parameter to this request to show your app name on the verification_url page. This concretes user trust in authorizing your application to use their TorBox account. This is not required, but is a good idea. Default is \"Third Party App\". This name is also only allowed to be alpha-numeric characters (A-Z,0-9). Anything else will be filtered our when being shown to the user. The friendly_verification_url will always show \"Third Party App\" to keep the URL short.
The device_code is only valid for 10 minutes. Make sure the user is aware of this time limit so they submit and login before this time limit is over.
\nAuthorization
\nNone required.
\n","urlObject":{"path":["{{api_version}}","api","user","auth","device","start"],"host":["{{api_base}}"],"query":[{"description":{"content":"The app name that the user will see when verifying the code. This should be the name of your app.
\n","type":"text/plain"},"key":"app","value":"Third Party App"}],"variable":[]}},"response":[{"id":"0208174d-5633-4eef-baf5-c7f9e64b3be7","name":"Success","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{api_base}}/{{api_version}}/api/user/auth/device/start?app=Third Party App","host":["{{api_base}}"],"path":["{{api_version}}","api","user","auth","device","start"],"query":[{"key":"app","value":"Third Party App","description":"The app name that the user will see when verifying the code. This should be the name of your app."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n\t\"success\": true,\n\t\"error\": null,\n\t\"detail\": \"Successfully created your device code authorization.\",\n\t\"data\": {\n\t\t\"device_code\": \"string\",\n\t\t\"interval\": 0,\n\t\t\"expires_at\": \"2025-08-24T15:18:28Z\",\n\t\t\"verification_url\": \"https://torbox.app/oauth/device?app=ThirdPartyApp\",\n\t\t\"friendly_verification_url\": \"https://tor.box/link\",\n\t\t\"code\": \"string\"\n\t}\n}"},{"id":"13825f4a-7c8c-43a3-adbf-cdc96aaaa53c","name":"Fail UNKNOWN_ERROR","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{api_base}}/{{api_version}}/api/user/auth/device/start?app=Third Party App","host":["{{api_base}}"],"path":["{{api_version}}","api","user","auth","device","start"],"query":[{"key":"app","value":"Third Party App","description":"The app name that the user will see when verifying the code. This should be the name of your app."}]}},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"UNKNOWN_ERROR\",\n \"detail\": \"There was an error creating your device code authorization. Please try again later.\",\n \"data\": \"error\"\n}"}],"_postman_id":"744bc274-88b7-4faf-a833-e30573c8c1e0"},{"name":"Get Token From Device Code Process","id":"6169f2b1-85e4-4990-9ce1-f4be25bd50c8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"device_code\": \"XXXXXXXXXXXXXXXXXXXXXXXXX\"\n}","options":{"raw":{"language":"json"}}},"url":"{{api_base}}/{{api_version}}/api/user/auth/device/token","description":"Overview
\nGets the user's API token from the device code authorization process. This endpoint is expected to be polled in interval until it returns success, or until the expiry has passed. All data you need for this request is in the original request, which includes the interval to be polled by, the expiry time to stop at, and device_code to be sent to the API to get the correct data.
Authorization
\nNone required.
\n","urlObject":{"path":["{{api_version}}","api","user","auth","device","token"],"host":["{{api_base}}"],"query":[],"variable":[]}},"response":[{"id":"ae3dd6f5-37be-4701-aac5-d161fccd68b0","name":"Success","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"device_code\": \"XXXXXXXXXXXXXXXXXXXXXXXXX\"\n}","options":{"raw":{"language":"json"}}},"url":"{{api_base}}/{{api_version}}/api/user/auth/device/token"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n\t\"success\": true,\n\t\"error\": null,\n\t\"detail\": \"Token has been successfully redeemed. Save this token as it will be used for all future API requests for this device.\",\n\t\"data\": {\n\t\t\"access_token\": \"XXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX\",\n\t\t\"token_type\": \"Bearer\"\n\t}\n}"},{"id":"888e45f2-b9ad-4544-a513-fe57a9a94a25","name":"Fail ITEM_NOT_FOUND","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"device_code\": \"XXXXXXXXXXXXXXXXXXXXXXXXX\"\n}","options":{"raw":{"language":"json"}}},"url":"{{api_base}}/{{api_version}}/api/user/auth/device/token"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"ITEM_NOT_FOUND\",\n \"detail\": \"The device code you entered is invalid or has expired. Please try again.\",\n \"data\": null\n}"},{"id":"042f1cc8-2b73-44ef-9263-cd97fb7f923c","name":"Fail DEVICE_CODE_NOT_USED","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"device_code\": \"XXXXXXXXXXXXXXXXXXXXXXXXX\"\n}","options":{"raw":{"language":"json"}}},"url":"{{api_base}}/{{api_version}}/api/user/auth/device/token"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"DEVICE_CODE_NOT_USED\",\n \"detail\": \"This device code has not been used yet. Please wait for the user to scan the code.\",\n \"data\": null\n}"},{"id":"b68c3f23-c967-4c67-8041-22404ec35702","name":"Fail DATABASE_ERROR","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"device_code\": \"XXXXXXXXXXXXXXXXXXXXXXXXX\"\n}","options":{"raw":{"language":"json"}}},"url":"{{api_base}}/{{api_version}}/api/user/auth/device/token"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"DATABASE_ERROR\",\n \"detail\": \"No API token found for this user. Please try again later.\",\n \"data\": null\n}"},{"id":"5918b70f-72ab-4f74-911f-98eb35b0ea4c","name":"Fail UNKNOWN_ERROR","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"device_code\": \"XXXXXXXXXXXXXXXXXXXXXXXXX\"\n}","options":{"raw":{"language":"json"}}},"url":"{{api_base}}/{{api_version}}/api/user/auth/device/token"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"UNKNOWN_ERROR\",\n \"detail\": \"There was an error redeeming your token. Please try again later.\",\n \"data\": \"error\"\n}"}],"_postman_id":"6169f2b1-85e4-4990-9ce1-f4be25bd50c8"},{"name":"Get Referral Data","id":"eb5bd5bd-0d7b-4014-bf2b-497a87cc6a97","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[],"url":"{{api_base}}/{{api_version}}/api/user/referraldata","description":"Overview
\nUse this endpoint to get the user's referral data. This includes information such as how many referrals they have made, and their referral code.
\nAuthorization
\nRequires an API key using the Authorization Bearer Header.
\n","urlObject":{"path":["{{api_version}}","api","user","referraldata"],"host":["{{api_base}}"],"query":[],"variable":[]}},"response":[{"id":"5ef2f668-6370-47c3-b13a-b06dd2ba3f40","name":"Success","originalRequest":{"method":"GET","header":[],"url":"{{api_base}}/{{api_version}}/api/user/referraldata"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"error\": null,\n \"detail\": \"Successfully retrieved referral data.\",\n \"data\": {\n \"referred_accounts\": 0,\n \"referral_code\": \"string\",\n \"purchases_referred\": 0\n }\n}"},{"id":"f45be2de-9f98-4788-84b8-8100f89a649c","name":"Fail AUTH_ERROR","originalRequest":{"method":"GET","header":[],"url":"{{api_base}}/{{api_version}}/api/user/referraldata"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"AUTH_ERROR\",\n \"detail\": \"There was an error verifying your API key. Please try again later.\",\n \"data\": null\n}"},{"id":"76802ea0-991c-4508-afb0-4becabc455b6","name":"Fail DATABASE_ERROR","originalRequest":{"method":"GET","header":[],"url":"{{api_base}}/{{api_version}}/api/user/referraldata"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"DATABASE_ERROR\",\n \"detail\": \"There was an error processing your request. Please try again later.\",\n \"data\": null\n}"},{"id":"39276614-af2d-489a-9fe9-ff60899c53e4","name":"Fail UNKNOWN_ERROR","originalRequest":{"method":"GET","header":[],"url":"{{api_base}}/{{api_version}}/api/user/referraldata"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"UNKNOWN_ERROR\",\n \"detail\": \"There was an error retrieving your referral data. Please try again later.\",\n \"data\": null\n}"},{"id":"896703f7-70b4-4174-a6a5-3c43e3d0d1b3","name":"Fail NO_AUTH","originalRequest":{"method":"GET","header":[],"url":"{{api_base}}/{{api_version}}/api/user/referraldata"},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"detail\": \"Please provide a valid API token.\",\n \"error\": \"NO_AUTH\",\n \"data\": null\n}"},{"id":"0d856365-b367-4b76-877e-a0ecb4fdbad3","name":"Fail BAD_TOKEN","originalRequest":{"method":"GET","header":[],"url":"{{api_base}}/{{api_version}}/api/user/referraldata"},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"BAD_TOKEN\",\n \"detail\": \"Your token is invalid or has expired. Please log in again or reset your token.\",\n \"data\": null\n}"}],"_postman_id":"eb5bd5bd-0d7b-4014-bf2b-497a87cc6a97"},{"name":"Get Subscriptions","id":"bb1307f2-ce3b-4625-a5be-e6ea1ab46a61","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[],"url":"{{api_base}}/{{api_version}}/api/user/subscriptions","description":"Overview
\nGets a users subscriptions. This includes active and inactive subscriptions for all payment processors.
\nIt should be noted that \"plan_code\" is not normalized to the standard plan codes such as 1, 2, or 3. These \"plan_code\"s are payment processor specific and used internally. If you want to display these subscriptions, use the \"plan_name\".
\nFor displaying information to users, use the \"status\", \"gateway\", and \"plan_name\". No other information is relevant to the user, and the rest is used for TorBox internally.
\nAuthorization
\nRequires an API key using the Authorization Bearer Header.
\n","urlObject":{"path":["{{api_version}}","api","user","subscriptions"],"host":["{{api_base}}"],"query":[],"variable":[]}},"response":[{"id":"438b9883-6792-4d38-8638-ac15cea36e85","name":"Success","originalRequest":{"method":"GET","header":[]},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n\t\"success\": true,\n\t\"error\": null,\n\t\"detail\": \"Successfully retrieved subscriptions.\",\n\t\"data\": [\n\t\t{\n\t\t\t\"created_at\": \"2025-03-14T08:08:42Z\",\n\t\t\t\"updated_at\": \"2025-08-04T18:37:44Z\",\n\t\t\t\"subscription_code\": \"string\",\n\t\t\t\"email_token\": \"string\",\n\t\t\t\"auth_id\": \"string\",\n\t\t\t\"plan_code\": \"string\",\n\t\t\t\"status\": \"string\",\n\t\t\t\"gateway\": \"string\",\n\t\t\t\"plan_name\": \"string\"\n\t\t}\n\t]\n}"},{"id":"6b5d895d-cf43-4909-8d08-ae6f948b545e","name":"Fail DATABASE_ERROR","originalRequest":{"method":"GET","header":[],"url":"{{api_base}}/{{api_version}}/api/user/subscriptions"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"DATABASE_ERROR\",\n \"detail\": \"An unknown error occurred. Please try again later.\",\n \"data\": null\n}"},{"id":"28480ac0-adc2-42e6-aac5-72e11761fc99","name":"Fail UNKNOWN_ERROR","originalRequest":{"method":"GET","header":[],"url":"{{api_base}}/{{api_version}}/api/user/subscriptions"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"UNKNOWN_ERROR\",\n \"detail\": \"There was an error retrieving your referral data. Please try again later.\",\n \"data\": null\n}"},{"id":"0c813495-fa1d-4436-a1e3-6a766f61de0f","name":"Fail AUTH_ERROR","originalRequest":{"method":"GET","header":[],"url":"{{api_base}}/{{api_version}}/api/user/subscriptions"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"AUTH_ERROR\",\n \"detail\": \"There was an error verifying your API key. Please try again later.\",\n \"data\": null\n}"},{"id":"ac42256f-7c15-46d8-89e7-f23cdd09869f","name":"Fail NO_AUTH","originalRequest":{"method":"GET","header":[],"url":"{{api_base}}/{{api_version}}/api/user/subscriptions"},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"detail\": \"Please provide a valid API token.\",\n \"error\": \"NO_AUTH\",\n \"data\": null\n}"},{"id":"5e0ba352-1436-4d02-aada-5af01597e0e4","name":"Fail BAD_TOKEN","originalRequest":{"method":"GET","header":[],"url":"{{api_base}}/{{api_version}}/api/user/subscriptions"},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"BAD_TOKEN\",\n \"detail\": \"Your token is invalid or has expired. Please log in again or reset your token.\",\n \"data\": null\n}"}],"_postman_id":"bb1307f2-ce3b-4625-a5be-e6ea1ab46a61"},{"name":"Get Transactions","id":"4205b949-fa83-46e8-8efb-dfa35187b890","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[],"url":"{{api_base}}/{{api_version}}/api/user/transactions","description":"Overview
\nUse this endpoint to get the user's list of transactions. This data isn't exactly relevant to a third party developer, unless you want to build full parity with TorBox's dashboard, or simply want to show this information.
\nAuthorization
\nRequires an API key using the Authorization Bearer Header.
\n","urlObject":{"path":["{{api_version}}","api","user","transactions"],"host":["{{api_base}}"],"query":[],"variable":[]}},"response":[{"id":"eff13117-d286-434b-9621-87116a7a2c39","name":"Success","originalRequest":{"method":"GET","header":[],"url":"{{api_base}}/{{api_version}}/api/user/transactions"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n\t\"success\": true,\n\t\"error\": null,\n\t\"detail\": \"Successfully retrieved transactions.\",\n\t\"data\": [\n\t\t{\n\t\t\t\"at\": \"2023-09-01T02:05:28Z\",\n\t\t\t\"type\": \"string\",\n\t\t\t\"amount\": 0,\n\t\t\t\"transaction_id\": \"string\"\n\t\t},\n\t\t{\n\t\t\t\"at\": \"2023-09-01T02:06:28Z\",\n\t\t\t\"type\": \"string\",\n\t\t\t\"amount\": 0,\n\t\t\t\"transaction_id\": \"string\"\n\t\t}\n\t]\n}"},{"id":"19135e5b-5c9d-4783-811d-cab368d3186b","name":"Fail UNKNOWN_ERROR","originalRequest":{"method":"GET","header":[],"url":"{{api_base}}/{{api_version}}/api/user/transactions"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"UNKNOWN_ERROR\",\n \"detail\": \"There was an error retrieving your referral data. Please try again later.\",\n \"data\": null\n}"},{"id":"e57955dc-aa4e-4dbe-baf7-4f3293d9a65a","name":"Fail AUTH_ERROR","originalRequest":{"method":"GET","header":[],"url":"{{api_base}}/{{api_version}}/api/user/transactions"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"AUTH_ERROR\",\n \"detail\": \"There was an error verifying your API key. Please try again later.\",\n \"data\": null\n}"},{"id":"87136850-51ab-4c23-be04-e553314e2f43","name":"Fail DATABASE_ERROR","originalRequest":{"method":"GET","header":[],"url":"{{api_base}}/{{api_version}}/api/user/transactions"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"DATABASE_ERROR\",\n \"detail\": \"An unknown error occurred. Please try again later.\",\n \"data\": null\n}"},{"id":"a853f3e7-0d4b-4621-97b5-d0bfe9a3fafa","name":"Fail NO_AUTH","originalRequest":{"method":"GET","header":[],"url":"{{api_base}}/{{api_version}}/api/user/transactions"},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"detail\": \"Please provide a valid API token.\",\n \"error\": \"NO_AUTH\",\n \"data\": null\n}"},{"id":"ffc523eb-b514-47b5-a756-e7b3b149edc2","name":"Fail BAD_TOKEN","originalRequest":{"method":"GET","header":[],"url":"{{api_base}}/{{api_version}}/api/user/transactions"},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"BAD_TOKEN\",\n \"detail\": \"Your token is invalid or has expired. Please log in again or reset your token.\",\n \"data\": null\n}"}],"_postman_id":"4205b949-fa83-46e8-8efb-dfa35187b890"},{"name":"Get Transaction PDF","id":"a55ecc56-3844-4874-a343-177c49d80773","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[],"url":"{{api_base}}/{{api_version}}/api/user/transaction/pdf?transaction_id","description":"Overview
\nGenerates a PDF of the transaction information. Requires the transaction ID from the \"Get Transactions\" request.
\nAuthorization
\nRequires an API key using the Authorization Bearer Header.
\n","urlObject":{"path":["{{api_version}}","api","user","transaction","pdf"],"host":["{{api_base}}"],"query":[{"description":{"content":"The transaction ID that you want to generate the PDF for.
\n","type":"text/plain"},"key":"transaction_id","value":null}],"variable":[]}},"response":[{"id":"a65a7ba4-bbc2-4b81-aab4-e13049917c1e","name":"Success","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{api_base}}/{{api_version}}/api/user/transaction/pdf?transaction_id","host":["{{api_base}}"],"path":["{{api_version}}","api","user","transaction","pdf"],"query":[{"key":"transaction_id","value":null,"description":"The transaction ID that you want to generate the PDF for."}]}},"status":"OK","code":200,"_postman_previewlanguage":"text","header":[{"key":"Content-Type","value":"application/pdf","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":""},{"id":"82e18469-914d-4f8f-b704-f98c286da034","name":"Fail ITEM_NOT_FOUND","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{api_base}}/{{api_version}}/api/user/transaction/pdf?transaction_id","host":["{{api_base}}"],"path":["{{api_version}}","api","user","transaction","pdf"],"query":[{"key":"transaction_id","value":null,"description":"The transaction ID that you want to generate the PDF for."}]}},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"ITEM_NOT_FOUND\",\n \"detail\": \"The transaction you are trying to generate a PDF for does not exist.\",\n \"data\": null\n}"},{"id":"e44452ed-45ac-405b-827c-53426c6aaa2c","name":"Fail UNKNOWN_ERROR","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{api_base}}/{{api_version}}/api/user/transaction/pdf?transaction_id","host":["{{api_base}}"],"path":["{{api_version}}","api","user","transaction","pdf"],"query":[{"key":"transaction_id","value":null,"description":"The transaction ID that you want to generate the PDF for."}]}},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"UNKNOWN_ERROR\",\n \"detail\": \"There was an error generating your transaction PDF. Please try again later.\",\n \"data\": null\n}"},{"id":"85cc2784-0d7f-4a2f-9373-95732a7704cb","name":"Fail AUTH_ERROR","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{api_base}}/{{api_version}}/api/user/transaction/pdf?transaction_id","host":["{{api_base}}"],"path":["{{api_version}}","api","user","transaction","pdf"],"query":[{"key":"transaction_id","value":null,"description":"The transaction ID that you want to generate the PDF for."}]}},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"AUTH_ERROR\",\n \"detail\": \"There was an error verifying your API key. Please try again later.\",\n \"data\": null\n}"}],"_postman_id":"a55ecc56-3844-4874-a343-177c49d80773"},{"name":"Edit User Settings","id":"263427ea-0129-4f59-a0e4-11ef3e9364f4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PUT","header":[],"body":{"mode":"raw","raw":"{\n \"email_notifications\": true, // When the user recieves a notification, send to registered email\n \"web_notifications\": true, // When the user recieves a notification, send to web (if browser is open, otherwise it will be in their notifications panel)\n \"mobile_notifications\": true, // When the user recieves a notification, send to TorBox mobile app (deprecated)\n \"rss_notifications\": true, // When the user recieves a notification, add to user's RSS feed\n \"download_speed_in_tab\": true, // Shows download speed in tab name in browser when using the TorBox dashboard. Third party apps may still use this setting.\n \"show_tracker_in_torrents\": true, // Shows active tracker in torrents on the TorBox dashboard. Third party apps may still use this setting.\n \"stremio_quality\": [ // Determines what qualities are shown to the user when using the TorBox Stremio addon. It is always recommended to include 0 (Unknown). Third party apps may still use this setting.\n 0, // Unknown Quality\n 1, // Cam Quality\n 2, // DVD-R Quality\n 3, // HDTV Quality\n 4, // HDRip Quality\n 5, // WEB-DL Quality\n 6, // WEBRip Quality\n 7, // Blu-Ray/BD/BDRip Quality\n 8, // HDR Quality\n 9, // HDR10 Quality\n 10, // HDR10+ Quality\n 11 // Dolby Vision Quality\n ],\n \"stremio_resolution\": [ // Determines what resolutions are shown to the user. It is always recommended to include 0 (Unknown). Third party apps may still use this setting.\n 0, // Unknown Resolution\n 1, // SD Resolution\n 2, // HD Resolution\n 3 // UHD Resolution\n ],\n \"stremio_language\": [ // Determines what languages are shown to the user. It is always recommended to include 0 (Unknown). Third party apps may still use this setting.\n 0, // Unknown\n 1, // English\n 2, // Spanish\n 3, // French\n 4, // German\n 5, // Italian\n 6, // Portuguese\n 7, // Russian\n 8, // Japanese\n 9, // Korean\n 10, // Chinese\n 11, // Arabic\n 12, // Hindi\n 13, // Bengali\n 14, // Ukrainian\n 15, // Nordic\n 16, // Czech\n 17, // Polish\n 18, // Tamil\n 19, // Telugu\n 20, // Kannada\n 21 // Dutch\n ],\n \"stremio_cache\": [ // Determines what cached status items to show to users. While this is an array, only a single value is accepted at a time to prevent issues. Still submit this as an array to the API. Third party apps may still use this setting.\n 1, // Cached and Download\n 2, // Cached Only\n 3 // Download Only\n ],\n \"stremio_size_lower\": 0, // The minimum size of files that will be shown to the user in the TorBox Stremio addon. Third party apps may still use this setting.\n \"google_drive_folder_id\": \"string\",\n \"onedrive_save_path\": \"string\",\n \"discord_id\": \"string\", \n \"discord_notifications\": true, // When the user recieves a notification, use the official TorBox Discord Bot to DM the user the notification. Must have a Discord_ID present and must share a server with the Discord Bot.\n \"stremio_allow_adult\": true, // Determines whether to show adult content on the TorBox Stremio addon. Third party apps may still use this setting.\n \"stremio_seed_torrents\": 0, // 1 = Auto, 2 = Always, 3 = Never\n \"seed_torrents\": 0, // 1 = Auto, 2 = Always, 3 = Never\n \"allow_zipped\": true,\n \"stremio_allow_zipped\": true,\n \"onefichier_folder_id\": \"string\",\n \"gofile_folder_id\": \"string\",\n \"jdownloader_notifications\": true,\n \"webhook_notifications\": true,\n \"webhook_url\": \"string\",\n \"telegram_notifications\": true,\n \"telegram_id\": \"string\",\n \"mega_email\": \"string\",\n \"mega_password\": \"string\",\n \"stremio_sort\": \"string\", // seeders = Seeders/Age (highest seeders first/lowest age first), size = Size (highest size first), resolution = Resolution (highest resolution first)\n \"cdn_selection\": \"string\", // any available CDN. Can be found using test file route\n \"stremio_use_custom_search_engines\": true,\n \"stremio_result_sort\": \"string\", // torrents = Torrents first, usenet = Usenet first\n \"webdav_use_local_files\": true, \n \"stremio_legacy_your_media\": true,\n \"stremio_only_your_media_streams\": true, // only shows Your Media streams in Stremio addon\n \"stremio_disable_your_media_streams\": true,\n \"webdav_use_folder_view\": true,\n \"webdav_flatten\": true,\n \"stremio_limit_per_resolution_torrent\": 0,\n \"stremio_limit_per_resolution_usenet\": 0,\n \"stremio_size_upper\": 0,\n \"stremio_torrent_seeders_cutoff\": 0,\n \"pixeldrain_api_key\": \"string\",\n \"onefichier_api_key\": \"string\",\n \"gofile_api_key\": \"string\",\n \"patreon_id\": \"string\",\n \"stremio_wait_for_download_usenet\": true,\n \"stremio_wait_for_download_torrent\": true,\n \"stremio_disable_filtered_note\": true,\n \"stremio_emoji_in_description\": true,\n \"dashboard_filter\": { // sorts the user's dashboard. Does not affect third party dashboards. This entire dict MUST be presented with all keys for any update to be given.\n \"torrents\": false,\n \"usenet_downloads\": false,\n \"web_downloads\": false,\n \"active\": false,\n \"inactive\": false,\n \"queued\": false,\n \"downloading\": false,\n \"uploading\": false,\n \"processing\": false,\n \"download_ready\": false,\n \"cached\": false,\n \"uncached\": false,\n \"private\": false,\n \"borrowed\": false\n },\n \"web_player_always_transcode\": true,\n \"web_player_always_skip_intro\": true,\n \"web_player_audio_preferred_language\": \"string\",\n \"web_player_subtitle_preferred_language\": \"string\",\n \"web_player_disable_prestream_selector\": true,\n \"dashboard_sort\": \"string\", // default = TorBox default sorting, name = AZ sorting, size = largest size first, added_date = newest first, cached_date = newest first, last_updated = newest first, progress = highest progress first, ratio = highest ratio first, download_speed = highest value first, upload_speed = highest value first, eta = smallest eta first\n \"web_player_disable_next_up_dialogue\": true,\n \"web_player_enable_scrobbling\": true,\n \"append_filename_to_links\": true\n}","options":{"raw":{"language":"json"}}},"url":"{{api_base}}/{{api_version}}/api/user/settings/editsettings","description":"Overview
\nEdits a user's TorBox settings. These values take effect immediately. Please view the body to read about allowed options and parameters.
\nTo get the user settings, simply use the \"Get User Data\" endpoint, while sending the \"?settings=true\" parameter
\nAuthorization
\nRequires an API key using the Authorization Bearer Header.
\n","auth":{"type":"bearer","bearer":{"token":"{{api_key}}"},"isInherited":true,"source":{"_postman_id":"4244cdaf-ece6-4b6d-a2ca-463a3af48f54","id":"4244cdaf-ece6-4b6d-a2ca-463a3af48f54","name":"Main API","type":"collection"}},"urlObject":{"path":["{{api_version}}","api","user","settings","editsettings"],"host":["{{api_base}}"],"query":[],"variable":[]}},"response":[{"id":"971843eb-cf38-4f32-8a19-c8698478ae04","name":"Success","originalRequest":{"method":"PUT","header":[],"body":{"mode":"raw","raw":"{\n \"email_notifications\": true, // When the user recieves a notification, send to registered email\n \"web_notifications\": true, // When the user recieves a notification, send to web (if browser is open, otherwise it will be in their notifications panel)\n \"mobile_notifications\": true, // When the user recieves a notification, send to TorBox mobile app (deprecated)\n \"rss_notifications\": true, // When the user recieves a notification, add to user's RSS feed\n \"download_speed_in_tab\": true, // Shows download speed in tab name in browser when using the TorBox dashboard. Third party apps may still use this setting.\n \"show_tracker_in_torrents\": true, // Shows active tracker in torrents on the TorBox dashboard. Third party apps may still use this setting.\n \"stremio_quality\": [ // Determines what qualities are shown to the user when using the TorBox Stremio addon. It is always recommended to include 0 (Unknown). Third party apps may still use this setting.\n 0, // Unknown Quality\n 1, // Cam Quality\n 2, // DVD-R Quality\n 3, // HDTV Quality\n 4, // HDRip Quality\n 5, // WEB-DL Quality\n 6, // WEBRip Quality\n 7, // Blu-Ray/BD/BDRip Quality\n 8, // HDR Quality\n 9, // HDR10 Quality\n 10, // HDR10+ Quality\n 11 // Dolby Vision Quality\n ],\n \"stremio_resolution\": [ // Determines what resolutions are shown to the user. It is always recommended to include 0 (Unknown). Third party apps may still use this setting.\n 0, // Unknown Resolution\n 1, // SD Resolution\n 2, // HD Resolution\n 3 // UHD Resolution\n ],\n \"stremio_language\": [ // Determines what languages are shown to the user. It is always recommended to include 0 (Unknown). Third party apps may still use this setting.\n 0, // Unknown\n 1, // English\n 2, // Spanish\n 3, // French\n 4, // German\n 5, // Italian\n 6, // Portuguese\n 7, // Russian\n 8, // Japanese\n 9, // Korean\n 10, // Chinese\n 11, // Arabic\n 12, // Hindi\n 13, // Bengali\n 14, // Ukrainian\n 15, // Nordic\n 16, // Czech\n 17, // Polish\n 18, // Tamil\n 19, // Telugu\n 20, // Kannada\n 21 // Dutch\n ],\n \"stremio_cache\": [ // Determines what cached status items to show to users. While this is an array, only a single value is accepted at a time to prevent issues. Still submit this as an array to the API. Third party apps may still use this setting.\n 1, // Cached and Download\n 2, // Cached Only\n 3 // Download Only\n ],\n \"stremio_size_lower\": 0, // The minimum size of files that will be shown to the user in the TorBox Stremio addon. Third party apps may still use this setting.\n \"google_drive_folder_id\": \"string\",\n \"onedrive_save_path\": \"string\",\n \"discord_id\": \"string\", \n \"discord_notifications\": true, // When the user recieves a notification, use the official TorBox Discord Bot to DM the user the notification. Must have a Discord_ID present and must share a server with the Discord Bot.\n \"stremio_allow_adult\": true, // Determines whether to show adult content on the TorBox Stremio addon. Third party apps may still use this setting.\n \"stremio_seed_torrents\": 0, // 1 = Auto, 2 = Always, 3 = Never\n \"seed_torrents\": 0, // 1 = Auto, 2 = Always, 3 = Never\n \"allow_zipped\": true,\n \"stremio_allow_zipped\": true,\n \"onefichier_folder_id\": \"string\",\n \"gofile_folder_id\": \"string\",\n \"jdownloader_notifications\": true,\n \"webhook_notifications\": true,\n \"webhook_url\": \"string\",\n \"telegram_notifications\": true,\n \"telegram_id\": \"string\",\n \"mega_email\": \"string\",\n \"mega_password\": \"string\",\n \"stremio_sort\": \"string\", // seeders = Seeders/Age (highest seeders first/lowest age first), size = Size (highest size first), resolution = Resolution (highest resolution first)\n \"cdn_selection\": \"string\", // any available CDN. Can be found using test file route\n \"stremio_use_custom_search_engines\": true,\n \"stremio_result_sort\": \"string\", // torrents = Torrents first, usenet = Usenet first\n \"webdav_use_local_files\": true, \n \"stremio_legacy_your_media\": true,\n \"stremio_only_your_media_streams\": true, // only shows Your Media streams in Stremio addon\n \"stremio_disable_your_media_streams\": true,\n \"webdav_use_folder_view\": true,\n \"webdav_flatten\": true,\n \"stremio_limit_per_resolution_torrent\": 0,\n \"stremio_limit_per_resolution_usenet\": 0,\n \"stremio_size_upper\": 0,\n \"stremio_torrent_seeders_cutoff\": 0,\n \"pixeldrain_api_key\": \"string\",\n \"onefichier_api_key\": \"string\",\n \"gofile_api_key\": \"string\",\n \"patreon_id\": \"string\",\n \"stremio_wait_for_download_usenet\": true,\n \"stremio_wait_for_download_torrent\": true,\n \"stremio_disable_filtered_note\": true,\n \"stremio_emoji_in_description\": true,\n \"dashboard_filter\": { // sorts the user's dashboard. Does not affect third party dashboards. This entire dict MUST be presented with all keys for any update to be given.\n \"torrents\": false,\n \"usenet_downloads\": false,\n \"web_downloads\": false,\n \"active\": false,\n \"inactive\": false,\n \"queued\": false,\n \"downloading\": false,\n \"uploading\": false,\n \"processing\": false,\n \"download_ready\": false,\n \"cached\": false,\n \"uncached\": false,\n \"private\": false,\n \"borrowed\": false\n },\n \"web_player_always_transcode\": true,\n \"web_player_always_skip_intro\": true,\n \"web_player_audio_preferred_language\": \"string\",\n \"web_player_subtitle_preferred_language\": \"string\",\n \"web_player_disable_prestream_selector\": true,\n \"dashboard_sort\": \"string\", // default = TorBox default sorting, name = AZ sorting, size = largest size first, added_date = newest first, cached_date = newest first, last_updated = newest first, progress = highest progress first, ratio = highest ratio first, download_speed = highest value first, upload_speed = highest value first, eta = smallest eta first\n \"web_player_disable_next_up_dialogue\": true,\n \"web_player_enable_scrobbling\": true,\n \"append_filename_to_links\": true\n}","options":{"raw":{"language":"json"}}},"url":"{{api_base}}/{{api_version}}/api/user/settings/editsettings"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"error\": null,\n \"detail\": \"User settings updated successfully.\",\n \"data\": null\n}"},{"id":"26bc013e-130e-4ef3-9dc0-1c67ca00f7d8","name":"Fail INVALID_OPTION","originalRequest":{"method":"PUT","header":[],"body":{"mode":"raw","raw":"{\n \"email_notifications\": true, // When the user recieves a notification, send to registered email\n \"web_notifications\": true, // When the user recieves a notification, send to web (if browser is open, otherwise it will be in their notifications panel)\n \"mobile_notifications\": true, // When the user recieves a notification, send to TorBox mobile app (deprecated)\n \"rss_notifications\": true, // When the user recieves a notification, add to user's RSS feed\n \"download_speed_in_tab\": true, // Shows download speed in tab name in browser when using the TorBox dashboard. Third party apps may still use this setting.\n \"show_tracker_in_torrents\": true, // Shows active tracker in torrents on the TorBox dashboard. Third party apps may still use this setting.\n \"stremio_quality\": [ // Determines what qualities are shown to the user when using the TorBox Stremio addon. It is always recommended to include 0 (Unknown). Third party apps may still use this setting.\n 0, // Unknown Quality\n 1, // Cam Quality\n 2, // DVD-R Quality\n 3, // HDTV Quality\n 4, // HDRip Quality\n 5, // WEB-DL Quality\n 6, // WEBRip Quality\n 7, // Blu-Ray/BD/BDRip Quality\n 8, // HDR Quality\n 9, // HDR10 Quality\n 10, // HDR10+ Quality\n 11 // Dolby Vision Quality\n ],\n \"stremio_resolution\": [ // Determines what resolutions are shown to the user. It is always recommended to include 0 (Unknown). Third party apps may still use this setting.\n 0, // Unknown Resolution\n 1, // SD Resolution\n 2, // HD Resolution\n 3 // UHD Resolution\n ],\n \"stremio_language\": [ // Determines what languages are shown to the user. It is always recommended to include 0 (Unknown). Third party apps may still use this setting.\n 0, // Unknown\n 1, // English\n 2, // Spanish\n 3, // French\n 4, // German\n 5, // Italian\n 6, // Portuguese\n 7, // Russian\n 8, // Japanese\n 9, // Korean\n 10, // Chinese\n 11, // Arabic\n 12, // Hindi\n 13, // Bengali\n 14, // Ukrainian\n 15, // Nordic\n 16, // Czech\n 17, // Polish\n 18, // Tamil\n 19, // Telugu\n 20, // Kannada\n 21 // Dutch\n ],\n \"stremio_cache\": [ // Determines what cached status items to show to users. While this is an array, only a single value is accepted at a time to prevent issues. Still submit this as an array to the API. Third party apps may still use this setting.\n 1, // Cached and Download\n 2, // Cached Only\n 3 // Download Only\n ],\n \"stremio_size_lower\": 0, // The minimum size of files that will be shown to the user in the TorBox Stremio addon. Third party apps may still use this setting.\n \"google_drive_folder_id\": \"string\",\n \"onedrive_save_path\": \"string\",\n \"discord_id\": \"string\", \n \"discord_notifications\": true, // When the user recieves a notification, use the official TorBox Discord Bot to DM the user the notification. Must have a Discord_ID present and must share a server with the Discord Bot.\n \"stremio_allow_adult\": true, // Determines whether to show adult content on the TorBox Stremio addon. Third party apps may still use this setting.\n \"stremio_seed_torrents\": 0, // 1 = Auto, 2 = Always, 3 = Never\n \"seed_torrents\": 0, // 1 = Auto, 2 = Always, 3 = Never\n \"allow_zipped\": true,\n \"stremio_allow_zipped\": true,\n \"onefichier_folder_id\": \"string\",\n \"gofile_folder_id\": \"string\",\n \"jdownloader_notifications\": true,\n \"webhook_notifications\": true,\n \"webhook_url\": \"string\",\n \"telegram_notifications\": true,\n \"telegram_id\": \"string\",\n \"mega_email\": \"string\",\n \"mega_password\": \"string\",\n \"stremio_sort\": \"string\", // seeders = Seeders/Age (highest seeders first/lowest age first), size = Size (highest size first), resolution = Resolution (highest resolution first)\n \"cdn_selection\": \"string\", // any available CDN. Can be found using test file route\n \"stremio_use_custom_search_engines\": true,\n \"stremio_result_sort\": \"string\", // torrents = Torrents first, usenet = Usenet first\n \"webdav_use_local_files\": true, \n \"stremio_legacy_your_media\": true,\n \"stremio_only_your_media_streams\": true, // only shows Your Media streams in Stremio addon\n \"stremio_disable_your_media_streams\": true,\n \"webdav_use_folder_view\": true,\n \"webdav_flatten\": true,\n \"stremio_limit_per_resolution_torrent\": 0,\n \"stremio_limit_per_resolution_usenet\": 0,\n \"stremio_size_upper\": 0,\n \"stremio_torrent_seeders_cutoff\": 0,\n \"pixeldrain_api_key\": \"string\",\n \"onefichier_api_key\": \"string\",\n \"gofile_api_key\": \"string\",\n \"patreon_id\": \"string\",\n \"stremio_wait_for_download_usenet\": true,\n \"stremio_wait_for_download_torrent\": true,\n \"stremio_disable_filtered_note\": true,\n \"stremio_emoji_in_description\": true,\n \"dashboard_filter\": { // sorts the user's dashboard. Does not affect third party dashboards. This entire dict MUST be presented with all keys for any update to be given.\n \"torrents\": false,\n \"usenet_downloads\": false,\n \"web_downloads\": false,\n \"active\": false,\n \"inactive\": false,\n \"queued\": false,\n \"downloading\": false,\n \"uploading\": false,\n \"processing\": false,\n \"download_ready\": false,\n \"cached\": false,\n \"uncached\": false,\n \"private\": false,\n \"borrowed\": false\n },\n \"web_player_always_transcode\": true,\n \"web_player_always_skip_intro\": true,\n \"web_player_audio_preferred_language\": \"string\",\n \"web_player_subtitle_preferred_language\": \"string\",\n \"web_player_disable_prestream_selector\": true,\n \"dashboard_sort\": \"string\", // default = TorBox default sorting, name = AZ sorting, size = largest size first, added_date = newest first, cached_date = newest first, last_updated = newest first, progress = highest progress first, ratio = highest ratio first, download_speed = highest value first, upload_speed = highest value first, eta = smallest eta first\n \"web_player_disable_next_up_dialogue\": true,\n \"web_player_enable_scrobbling\": true,\n \"append_filename_to_links\": true\n}","options":{"raw":{"language":"json"}}},"url":"{{api_base}}/{{api_version}}/api/user/settings/editsettings"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"INVALID_OPTION\",\n \"detail\": \"No valid settings were provided to update.\",\n \"data\": null\n}"},{"id":"38daccb2-5dfe-4203-abb3-3f617f710998","name":"Fail DATABASE_ERROR","originalRequest":{"method":"PUT","header":[],"body":{"mode":"raw","raw":"{\n \"email_notifications\": true, // When the user recieves a notification, send to registered email\n \"web_notifications\": true, // When the user recieves a notification, send to web (if browser is open, otherwise it will be in their notifications panel)\n \"mobile_notifications\": true, // When the user recieves a notification, send to TorBox mobile app (deprecated)\n \"rss_notifications\": true, // When the user recieves a notification, add to user's RSS feed\n \"download_speed_in_tab\": true, // Shows download speed in tab name in browser when using the TorBox dashboard. Third party apps may still use this setting.\n \"show_tracker_in_torrents\": true, // Shows active tracker in torrents on the TorBox dashboard. Third party apps may still use this setting.\n \"stremio_quality\": [ // Determines what qualities are shown to the user when using the TorBox Stremio addon. It is always recommended to include 0 (Unknown). Third party apps may still use this setting.\n 0, // Unknown Quality\n 1, // Cam Quality\n 2, // DVD-R Quality\n 3, // HDTV Quality\n 4, // HDRip Quality\n 5, // WEB-DL Quality\n 6, // WEBRip Quality\n 7, // Blu-Ray/BD/BDRip Quality\n 8, // HDR Quality\n 9, // HDR10 Quality\n 10, // HDR10+ Quality\n 11 // Dolby Vision Quality\n ],\n \"stremio_resolution\": [ // Determines what resolutions are shown to the user. It is always recommended to include 0 (Unknown). Third party apps may still use this setting.\n 0, // Unknown Resolution\n 1, // SD Resolution\n 2, // HD Resolution\n 3 // UHD Resolution\n ],\n \"stremio_language\": [ // Determines what languages are shown to the user. It is always recommended to include 0 (Unknown). Third party apps may still use this setting.\n 0, // Unknown\n 1, // English\n 2, // Spanish\n 3, // French\n 4, // German\n 5, // Italian\n 6, // Portuguese\n 7, // Russian\n 8, // Japanese\n 9, // Korean\n 10, // Chinese\n 11, // Arabic\n 12, // Hindi\n 13, // Bengali\n 14, // Ukrainian\n 15, // Nordic\n 16, // Czech\n 17, // Polish\n 18, // Tamil\n 19, // Telugu\n 20, // Kannada\n 21 // Dutch\n ],\n \"stremio_cache\": [ // Determines what cached status items to show to users. While this is an array, only a single value is accepted at a time to prevent issues. Still submit this as an array to the API. Third party apps may still use this setting.\n 1, // Cached and Download\n 2, // Cached Only\n 3 // Download Only\n ],\n \"stremio_size_lower\": 0, // The minimum size of files that will be shown to the user in the TorBox Stremio addon. Third party apps may still use this setting.\n \"google_drive_folder_id\": \"string\",\n \"onedrive_save_path\": \"string\",\n \"discord_id\": \"string\", \n \"discord_notifications\": true, // When the user recieves a notification, use the official TorBox Discord Bot to DM the user the notification. Must have a Discord_ID present and must share a server with the Discord Bot.\n \"stremio_allow_adult\": true, // Determines whether to show adult content on the TorBox Stremio addon. Third party apps may still use this setting.\n \"stremio_seed_torrents\": 0, // 1 = Auto, 2 = Always, 3 = Never\n \"seed_torrents\": 0, // 1 = Auto, 2 = Always, 3 = Never\n \"allow_zipped\": true,\n \"stremio_allow_zipped\": true,\n \"onefichier_folder_id\": \"string\",\n \"gofile_folder_id\": \"string\",\n \"jdownloader_notifications\": true,\n \"webhook_notifications\": true,\n \"webhook_url\": \"string\",\n \"telegram_notifications\": true,\n \"telegram_id\": \"string\",\n \"mega_email\": \"string\",\n \"mega_password\": \"string\",\n \"stremio_sort\": \"string\", // seeders = Seeders/Age (highest seeders first/lowest age first), size = Size (highest size first), resolution = Resolution (highest resolution first)\n \"cdn_selection\": \"string\", // any available CDN. Can be found using test file route\n \"stremio_use_custom_search_engines\": true,\n \"stremio_result_sort\": \"string\", // torrents = Torrents first, usenet = Usenet first\n \"webdav_use_local_files\": true, \n \"stremio_legacy_your_media\": true,\n \"stremio_only_your_media_streams\": true, // only shows Your Media streams in Stremio addon\n \"stremio_disable_your_media_streams\": true,\n \"webdav_use_folder_view\": true,\n \"webdav_flatten\": true,\n \"stremio_limit_per_resolution_torrent\": 0,\n \"stremio_limit_per_resolution_usenet\": 0,\n \"stremio_size_upper\": 0,\n \"stremio_torrent_seeders_cutoff\": 0,\n \"pixeldrain_api_key\": \"string\",\n \"onefichier_api_key\": \"string\",\n \"gofile_api_key\": \"string\",\n \"patreon_id\": \"string\",\n \"stremio_wait_for_download_usenet\": true,\n \"stremio_wait_for_download_torrent\": true,\n \"stremio_disable_filtered_note\": true,\n \"stremio_emoji_in_description\": true,\n \"dashboard_filter\": { // sorts the user's dashboard. Does not affect third party dashboards. This entire dict MUST be presented with all keys for any update to be given.\n \"torrents\": false,\n \"usenet_downloads\": false,\n \"web_downloads\": false,\n \"active\": false,\n \"inactive\": false,\n \"queued\": false,\n \"downloading\": false,\n \"uploading\": false,\n \"processing\": false,\n \"download_ready\": false,\n \"cached\": false,\n \"uncached\": false,\n \"private\": false,\n \"borrowed\": false\n },\n \"web_player_always_transcode\": true,\n \"web_player_always_skip_intro\": true,\n \"web_player_audio_preferred_language\": \"string\",\n \"web_player_subtitle_preferred_language\": \"string\",\n \"web_player_disable_prestream_selector\": true,\n \"dashboard_sort\": \"string\", // default = TorBox default sorting, name = AZ sorting, size = largest size first, added_date = newest first, cached_date = newest first, last_updated = newest first, progress = highest progress first, ratio = highest ratio first, download_speed = highest value first, upload_speed = highest value first, eta = smallest eta first\n \"web_player_disable_next_up_dialogue\": true,\n \"web_player_enable_scrobbling\": true,\n \"append_filename_to_links\": true\n}","options":{"raw":{"language":"json"}}},"url":"{{api_base}}/{{api_version}}/api/user/settings/editsettings"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"DATABASE_ERROR\",\n \"detail\": \"An unknown error occurred while updating user settings. Please try again later.\",\n \"data\": null\n}"},{"id":"9a07fa0c-a98f-460f-9a6a-e7f7443b083c","name":"Fail UNKNOWN_ERROR","originalRequest":{"method":"PUT","header":[],"body":{"mode":"raw","raw":"{\n \"email_notifications\": true, // When the user recieves a notification, send to registered email\n \"web_notifications\": true, // When the user recieves a notification, send to web (if browser is open, otherwise it will be in their notifications panel)\n \"mobile_notifications\": true, // When the user recieves a notification, send to TorBox mobile app (deprecated)\n \"rss_notifications\": true, // When the user recieves a notification, add to user's RSS feed\n \"download_speed_in_tab\": true, // Shows download speed in tab name in browser when using the TorBox dashboard. Third party apps may still use this setting.\n \"show_tracker_in_torrents\": true, // Shows active tracker in torrents on the TorBox dashboard. Third party apps may still use this setting.\n \"stremio_quality\": [ // Determines what qualities are shown to the user when using the TorBox Stremio addon. It is always recommended to include 0 (Unknown). Third party apps may still use this setting.\n 0, // Unknown Quality\n 1, // Cam Quality\n 2, // DVD-R Quality\n 3, // HDTV Quality\n 4, // HDRip Quality\n 5, // WEB-DL Quality\n 6, // WEBRip Quality\n 7, // Blu-Ray/BD/BDRip Quality\n 8, // HDR Quality\n 9, // HDR10 Quality\n 10, // HDR10+ Quality\n 11 // Dolby Vision Quality\n ],\n \"stremio_resolution\": [ // Determines what resolutions are shown to the user. It is always recommended to include 0 (Unknown). Third party apps may still use this setting.\n 0, // Unknown Resolution\n 1, // SD Resolution\n 2, // HD Resolution\n 3 // UHD Resolution\n ],\n \"stremio_language\": [ // Determines what languages are shown to the user. It is always recommended to include 0 (Unknown). Third party apps may still use this setting.\n 0, // Unknown\n 1, // English\n 2, // Spanish\n 3, // French\n 4, // German\n 5, // Italian\n 6, // Portuguese\n 7, // Russian\n 8, // Japanese\n 9, // Korean\n 10, // Chinese\n 11, // Arabic\n 12, // Hindi\n 13, // Bengali\n 14, // Ukrainian\n 15, // Nordic\n 16, // Czech\n 17, // Polish\n 18, // Tamil\n 19, // Telugu\n 20, // Kannada\n 21 // Dutch\n ],\n \"stremio_cache\": [ // Determines what cached status items to show to users. While this is an array, only a single value is accepted at a time to prevent issues. Still submit this as an array to the API. Third party apps may still use this setting.\n 1, // Cached and Download\n 2, // Cached Only\n 3 // Download Only\n ],\n \"stremio_size_lower\": 0, // The minimum size of files that will be shown to the user in the TorBox Stremio addon. Third party apps may still use this setting.\n \"google_drive_folder_id\": \"string\",\n \"onedrive_save_path\": \"string\",\n \"discord_id\": \"string\", \n \"discord_notifications\": true, // When the user recieves a notification, use the official TorBox Discord Bot to DM the user the notification. Must have a Discord_ID present and must share a server with the Discord Bot.\n \"stremio_allow_adult\": true, // Determines whether to show adult content on the TorBox Stremio addon. Third party apps may still use this setting.\n \"stremio_seed_torrents\": 0, // 1 = Auto, 2 = Always, 3 = Never\n \"seed_torrents\": 0, // 1 = Auto, 2 = Always, 3 = Never\n \"allow_zipped\": true,\n \"stremio_allow_zipped\": true,\n \"onefichier_folder_id\": \"string\",\n \"gofile_folder_id\": \"string\",\n \"jdownloader_notifications\": true,\n \"webhook_notifications\": true,\n \"webhook_url\": \"string\",\n \"telegram_notifications\": true,\n \"telegram_id\": \"string\",\n \"mega_email\": \"string\",\n \"mega_password\": \"string\",\n \"stremio_sort\": \"string\", // seeders = Seeders/Age (highest seeders first/lowest age first), size = Size (highest size first), resolution = Resolution (highest resolution first)\n \"cdn_selection\": \"string\", // any available CDN. Can be found using test file route\n \"stremio_use_custom_search_engines\": true,\n \"stremio_result_sort\": \"string\", // torrents = Torrents first, usenet = Usenet first\n \"webdav_use_local_files\": true, \n \"stremio_legacy_your_media\": true,\n \"stremio_only_your_media_streams\": true, // only shows Your Media streams in Stremio addon\n \"stremio_disable_your_media_streams\": true,\n \"webdav_use_folder_view\": true,\n \"webdav_flatten\": true,\n \"stremio_limit_per_resolution_torrent\": 0,\n \"stremio_limit_per_resolution_usenet\": 0,\n \"stremio_size_upper\": 0,\n \"stremio_torrent_seeders_cutoff\": 0,\n \"pixeldrain_api_key\": \"string\",\n \"onefichier_api_key\": \"string\",\n \"gofile_api_key\": \"string\",\n \"patreon_id\": \"string\",\n \"stremio_wait_for_download_usenet\": true,\n \"stremio_wait_for_download_torrent\": true,\n \"stremio_disable_filtered_note\": true,\n \"stremio_emoji_in_description\": true,\n \"dashboard_filter\": { // sorts the user's dashboard. Does not affect third party dashboards. This entire dict MUST be presented with all keys for any update to be given.\n \"torrents\": false,\n \"usenet_downloads\": false,\n \"web_downloads\": false,\n \"active\": false,\n \"inactive\": false,\n \"queued\": false,\n \"downloading\": false,\n \"uploading\": false,\n \"processing\": false,\n \"download_ready\": false,\n \"cached\": false,\n \"uncached\": false,\n \"private\": false,\n \"borrowed\": false\n },\n \"web_player_always_transcode\": true,\n \"web_player_always_skip_intro\": true,\n \"web_player_audio_preferred_language\": \"string\",\n \"web_player_subtitle_preferred_language\": \"string\",\n \"web_player_disable_prestream_selector\": true,\n \"dashboard_sort\": \"string\", // default = TorBox default sorting, name = AZ sorting, size = largest size first, added_date = newest first, cached_date = newest first, last_updated = newest first, progress = highest progress first, ratio = highest ratio first, download_speed = highest value first, upload_speed = highest value first, eta = smallest eta first\n \"web_player_disable_next_up_dialogue\": true,\n \"web_player_enable_scrobbling\": true,\n \"append_filename_to_links\": true\n}","options":{"raw":{"language":"json"}}},"url":"{{api_base}}/{{api_version}}/api/user/settings/editsettings"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"UNKNOWN_ERROR\",\n \"detail\": \"There was an error editing your general settings. Please try again later.\",\n \"data\": null\n}"},{"id":"ff1334b7-0b7f-4621-ae6a-ce96bd8a0aa4","name":"Fail AUTH_ERROR","originalRequest":{"method":"PUT","header":[],"body":{"mode":"raw","raw":"{\n \"email_notifications\": true, // When the user recieves a notification, send to registered email\n \"web_notifications\": true, // When the user recieves a notification, send to web (if browser is open, otherwise it will be in their notifications panel)\n \"mobile_notifications\": true, // When the user recieves a notification, send to TorBox mobile app (deprecated)\n \"rss_notifications\": true, // When the user recieves a notification, add to user's RSS feed\n \"download_speed_in_tab\": true, // Shows download speed in tab name in browser when using the TorBox dashboard. Third party apps may still use this setting.\n \"show_tracker_in_torrents\": true, // Shows active tracker in torrents on the TorBox dashboard. Third party apps may still use this setting.\n \"stremio_quality\": [ // Determines what qualities are shown to the user when using the TorBox Stremio addon. It is always recommended to include 0 (Unknown). Third party apps may still use this setting.\n 0, // Unknown Quality\n 1, // Cam Quality\n 2, // DVD-R Quality\n 3, // HDTV Quality\n 4, // HDRip Quality\n 5, // WEB-DL Quality\n 6, // WEBRip Quality\n 7, // Blu-Ray/BD/BDRip Quality\n 8, // HDR Quality\n 9, // HDR10 Quality\n 10, // HDR10+ Quality\n 11 // Dolby Vision Quality\n ],\n \"stremio_resolution\": [ // Determines what resolutions are shown to the user. It is always recommended to include 0 (Unknown). Third party apps may still use this setting.\n 0, // Unknown Resolution\n 1, // SD Resolution\n 2, // HD Resolution\n 3 // UHD Resolution\n ],\n \"stremio_language\": [ // Determines what languages are shown to the user. It is always recommended to include 0 (Unknown). Third party apps may still use this setting.\n 0, // Unknown\n 1, // English\n 2, // Spanish\n 3, // French\n 4, // German\n 5, // Italian\n 6, // Portuguese\n 7, // Russian\n 8, // Japanese\n 9, // Korean\n 10, // Chinese\n 11, // Arabic\n 12, // Hindi\n 13, // Bengali\n 14, // Ukrainian\n 15, // Nordic\n 16, // Czech\n 17, // Polish\n 18, // Tamil\n 19, // Telugu\n 20, // Kannada\n 21 // Dutch\n ],\n \"stremio_cache\": [ // Determines what cached status items to show to users. While this is an array, only a single value is accepted at a time to prevent issues. Still submit this as an array to the API. Third party apps may still use this setting.\n 1, // Cached and Download\n 2, // Cached Only\n 3 // Download Only\n ],\n \"stremio_size_lower\": 0, // The minimum size of files that will be shown to the user in the TorBox Stremio addon. Third party apps may still use this setting.\n \"google_drive_folder_id\": \"string\",\n \"onedrive_save_path\": \"string\",\n \"discord_id\": \"string\", \n \"discord_notifications\": true, // When the user recieves a notification, use the official TorBox Discord Bot to DM the user the notification. Must have a Discord_ID present and must share a server with the Discord Bot.\n \"stremio_allow_adult\": true, // Determines whether to show adult content on the TorBox Stremio addon. Third party apps may still use this setting.\n \"stremio_seed_torrents\": 0, // 1 = Auto, 2 = Always, 3 = Never\n \"seed_torrents\": 0, // 1 = Auto, 2 = Always, 3 = Never\n \"allow_zipped\": true,\n \"stremio_allow_zipped\": true,\n \"onefichier_folder_id\": \"string\",\n \"gofile_folder_id\": \"string\",\n \"jdownloader_notifications\": true,\n \"webhook_notifications\": true,\n \"webhook_url\": \"string\",\n \"telegram_notifications\": true,\n \"telegram_id\": \"string\",\n \"mega_email\": \"string\",\n \"mega_password\": \"string\",\n \"stremio_sort\": \"string\", // seeders = Seeders/Age (highest seeders first/lowest age first), size = Size (highest size first), resolution = Resolution (highest resolution first)\n \"cdn_selection\": \"string\", // any available CDN. Can be found using test file route\n \"stremio_use_custom_search_engines\": true,\n \"stremio_result_sort\": \"string\", // torrents = Torrents first, usenet = Usenet first\n \"webdav_use_local_files\": true, \n \"stremio_legacy_your_media\": true,\n \"stremio_only_your_media_streams\": true, // only shows Your Media streams in Stremio addon\n \"stremio_disable_your_media_streams\": true,\n \"webdav_use_folder_view\": true,\n \"webdav_flatten\": true,\n \"stremio_limit_per_resolution_torrent\": 0,\n \"stremio_limit_per_resolution_usenet\": 0,\n \"stremio_size_upper\": 0,\n \"stremio_torrent_seeders_cutoff\": 0,\n \"pixeldrain_api_key\": \"string\",\n \"onefichier_api_key\": \"string\",\n \"gofile_api_key\": \"string\",\n \"patreon_id\": \"string\",\n \"stremio_wait_for_download_usenet\": true,\n \"stremio_wait_for_download_torrent\": true,\n \"stremio_disable_filtered_note\": true,\n \"stremio_emoji_in_description\": true,\n \"dashboard_filter\": { // sorts the user's dashboard. Does not affect third party dashboards. This entire dict MUST be presented with all keys for any update to be given.\n \"torrents\": false,\n \"usenet_downloads\": false,\n \"web_downloads\": false,\n \"active\": false,\n \"inactive\": false,\n \"queued\": false,\n \"downloading\": false,\n \"uploading\": false,\n \"processing\": false,\n \"download_ready\": false,\n \"cached\": false,\n \"uncached\": false,\n \"private\": false,\n \"borrowed\": false\n },\n \"web_player_always_transcode\": true,\n \"web_player_always_skip_intro\": true,\n \"web_player_audio_preferred_language\": \"string\",\n \"web_player_subtitle_preferred_language\": \"string\",\n \"web_player_disable_prestream_selector\": true,\n \"dashboard_sort\": \"string\", // default = TorBox default sorting, name = AZ sorting, size = largest size first, added_date = newest first, cached_date = newest first, last_updated = newest first, progress = highest progress first, ratio = highest ratio first, download_speed = highest value first, upload_speed = highest value first, eta = smallest eta first\n \"web_player_disable_next_up_dialogue\": true,\n \"web_player_enable_scrobbling\": true,\n \"append_filename_to_links\": true\n}","options":{"raw":{"language":"json"}}},"url":"{{api_base}}/{{api_version}}/api/user/settings/editsettings"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"AUTH_ERROR\",\n \"detail\": \"There was an error verifying your API key. Please try again later.\",\n \"data\": null\n}"},{"id":"5b2d0627-5bfa-4db9-aea5-e1953f74af3e","name":"Fail NO_AUTH","originalRequest":{"method":"PUT","header":[],"body":{"mode":"raw","raw":"{\n \"email_notifications\": true, // When the user recieves a notification, send to registered email\n \"web_notifications\": true, // When the user recieves a notification, send to web (if browser is open, otherwise it will be in their notifications panel)\n \"mobile_notifications\": true, // When the user recieves a notification, send to TorBox mobile app (deprecated)\n \"rss_notifications\": true, // When the user recieves a notification, add to user's RSS feed\n \"download_speed_in_tab\": true, // Shows download speed in tab name in browser when using the TorBox dashboard. Third party apps may still use this setting.\n \"show_tracker_in_torrents\": true, // Shows active tracker in torrents on the TorBox dashboard. Third party apps may still use this setting.\n \"stremio_quality\": [ // Determines what qualities are shown to the user when using the TorBox Stremio addon. It is always recommended to include 0 (Unknown). Third party apps may still use this setting.\n 0, // Unknown Quality\n 1, // Cam Quality\n 2, // DVD-R Quality\n 3, // HDTV Quality\n 4, // HDRip Quality\n 5, // WEB-DL Quality\n 6, // WEBRip Quality\n 7, // Blu-Ray/BD/BDRip Quality\n 8, // HDR Quality\n 9, // HDR10 Quality\n 10, // HDR10+ Quality\n 11 // Dolby Vision Quality\n ],\n \"stremio_resolution\": [ // Determines what resolutions are shown to the user. It is always recommended to include 0 (Unknown). Third party apps may still use this setting.\n 0, // Unknown Resolution\n 1, // SD Resolution\n 2, // HD Resolution\n 3 // UHD Resolution\n ],\n \"stremio_language\": [ // Determines what languages are shown to the user. It is always recommended to include 0 (Unknown). Third party apps may still use this setting.\n 0, // Unknown\n 1, // English\n 2, // Spanish\n 3, // French\n 4, // German\n 5, // Italian\n 6, // Portuguese\n 7, // Russian\n 8, // Japanese\n 9, // Korean\n 10, // Chinese\n 11, // Arabic\n 12, // Hindi\n 13, // Bengali\n 14, // Ukrainian\n 15, // Nordic\n 16, // Czech\n 17, // Polish\n 18, // Tamil\n 19, // Telugu\n 20, // Kannada\n 21 // Dutch\n ],\n \"stremio_cache\": [ // Determines what cached status items to show to users. While this is an array, only a single value is accepted at a time to prevent issues. Still submit this as an array to the API. Third party apps may still use this setting.\n 1, // Cached and Download\n 2, // Cached Only\n 3 // Download Only\n ],\n \"stremio_size_lower\": 0, // The minimum size of files that will be shown to the user in the TorBox Stremio addon. Third party apps may still use this setting.\n \"google_drive_folder_id\": \"string\",\n \"onedrive_save_path\": \"string\",\n \"discord_id\": \"string\", \n \"discord_notifications\": true, // When the user recieves a notification, use the official TorBox Discord Bot to DM the user the notification. Must have a Discord_ID present and must share a server with the Discord Bot.\n \"stremio_allow_adult\": true, // Determines whether to show adult content on the TorBox Stremio addon. Third party apps may still use this setting.\n \"stremio_seed_torrents\": 0, // 1 = Auto, 2 = Always, 3 = Never\n \"seed_torrents\": 0, // 1 = Auto, 2 = Always, 3 = Never\n \"allow_zipped\": true,\n \"stremio_allow_zipped\": true,\n \"onefichier_folder_id\": \"string\",\n \"gofile_folder_id\": \"string\",\n \"jdownloader_notifications\": true,\n \"webhook_notifications\": true,\n \"webhook_url\": \"string\",\n \"telegram_notifications\": true,\n \"telegram_id\": \"string\",\n \"mega_email\": \"string\",\n \"mega_password\": \"string\",\n \"stremio_sort\": \"string\", // seeders = Seeders/Age (highest seeders first/lowest age first), size = Size (highest size first), resolution = Resolution (highest resolution first)\n \"cdn_selection\": \"string\", // any available CDN. Can be found using test file route\n \"stremio_use_custom_search_engines\": true,\n \"stremio_result_sort\": \"string\", // torrents = Torrents first, usenet = Usenet first\n \"webdav_use_local_files\": true, \n \"stremio_legacy_your_media\": true,\n \"stremio_only_your_media_streams\": true, // only shows Your Media streams in Stremio addon\n \"stremio_disable_your_media_streams\": true,\n \"webdav_use_folder_view\": true,\n \"webdav_flatten\": true,\n \"stremio_limit_per_resolution_torrent\": 0,\n \"stremio_limit_per_resolution_usenet\": 0,\n \"stremio_size_upper\": 0,\n \"stremio_torrent_seeders_cutoff\": 0,\n \"pixeldrain_api_key\": \"string\",\n \"onefichier_api_key\": \"string\",\n \"gofile_api_key\": \"string\",\n \"patreon_id\": \"string\",\n \"stremio_wait_for_download_usenet\": true,\n \"stremio_wait_for_download_torrent\": true,\n \"stremio_disable_filtered_note\": true,\n \"stremio_emoji_in_description\": true,\n \"dashboard_filter\": { // sorts the user's dashboard. Does not affect third party dashboards. This entire dict MUST be presented with all keys for any update to be given.\n \"torrents\": false,\n \"usenet_downloads\": false,\n \"web_downloads\": false,\n \"active\": false,\n \"inactive\": false,\n \"queued\": false,\n \"downloading\": false,\n \"uploading\": false,\n \"processing\": false,\n \"download_ready\": false,\n \"cached\": false,\n \"uncached\": false,\n \"private\": false,\n \"borrowed\": false\n },\n \"web_player_always_transcode\": true,\n \"web_player_always_skip_intro\": true,\n \"web_player_audio_preferred_language\": \"string\",\n \"web_player_subtitle_preferred_language\": \"string\",\n \"web_player_disable_prestream_selector\": true,\n \"dashboard_sort\": \"string\", // default = TorBox default sorting, name = AZ sorting, size = largest size first, added_date = newest first, cached_date = newest first, last_updated = newest first, progress = highest progress first, ratio = highest ratio first, download_speed = highest value first, upload_speed = highest value first, eta = smallest eta first\n \"web_player_disable_next_up_dialogue\": true,\n \"web_player_enable_scrobbling\": true,\n \"append_filename_to_links\": true\n}","options":{"raw":{"language":"json"}}},"url":"{{api_base}}/{{api_version}}/api/user/settings/editsettings"},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"detail\": \"Please provide a valid API token.\",\n \"error\": \"NO_AUTH\",\n \"data\": null\n}"},{"id":"d10af366-d1aa-432d-a3e2-03ec5e69d3cf","name":"Fail BAD_TOKEN","originalRequest":{"method":"PUT","header":[],"body":{"mode":"raw","raw":"{\n \"email_notifications\": true, // When the user recieves a notification, send to registered email\n \"web_notifications\": true, // When the user recieves a notification, send to web (if browser is open, otherwise it will be in their notifications panel)\n \"mobile_notifications\": true, // When the user recieves a notification, send to TorBox mobile app (deprecated)\n \"rss_notifications\": true, // When the user recieves a notification, add to user's RSS feed\n \"download_speed_in_tab\": true, // Shows download speed in tab name in browser when using the TorBox dashboard. Third party apps may still use this setting.\n \"show_tracker_in_torrents\": true, // Shows active tracker in torrents on the TorBox dashboard. Third party apps may still use this setting.\n \"stremio_quality\": [ // Determines what qualities are shown to the user when using the TorBox Stremio addon. It is always recommended to include 0 (Unknown). Third party apps may still use this setting.\n 0, // Unknown Quality\n 1, // Cam Quality\n 2, // DVD-R Quality\n 3, // HDTV Quality\n 4, // HDRip Quality\n 5, // WEB-DL Quality\n 6, // WEBRip Quality\n 7, // Blu-Ray/BD/BDRip Quality\n 8, // HDR Quality\n 9, // HDR10 Quality\n 10, // HDR10+ Quality\n 11 // Dolby Vision Quality\n ],\n \"stremio_resolution\": [ // Determines what resolutions are shown to the user. It is always recommended to include 0 (Unknown). Third party apps may still use this setting.\n 0, // Unknown Resolution\n 1, // SD Resolution\n 2, // HD Resolution\n 3 // UHD Resolution\n ],\n \"stremio_language\": [ // Determines what languages are shown to the user. It is always recommended to include 0 (Unknown). Third party apps may still use this setting.\n 0, // Unknown\n 1, // English\n 2, // Spanish\n 3, // French\n 4, // German\n 5, // Italian\n 6, // Portuguese\n 7, // Russian\n 8, // Japanese\n 9, // Korean\n 10, // Chinese\n 11, // Arabic\n 12, // Hindi\n 13, // Bengali\n 14, // Ukrainian\n 15, // Nordic\n 16, // Czech\n 17, // Polish\n 18, // Tamil\n 19, // Telugu\n 20, // Kannada\n 21 // Dutch\n ],\n \"stremio_cache\": [ // Determines what cached status items to show to users. While this is an array, only a single value is accepted at a time to prevent issues. Still submit this as an array to the API. Third party apps may still use this setting.\n 1, // Cached and Download\n 2, // Cached Only\n 3 // Download Only\n ],\n \"stremio_size_lower\": 0, // The minimum size of files that will be shown to the user in the TorBox Stremio addon. Third party apps may still use this setting.\n \"google_drive_folder_id\": \"string\",\n \"onedrive_save_path\": \"string\",\n \"discord_id\": \"string\", \n \"discord_notifications\": true, // When the user recieves a notification, use the official TorBox Discord Bot to DM the user the notification. Must have a Discord_ID present and must share a server with the Discord Bot.\n \"stremio_allow_adult\": true, // Determines whether to show adult content on the TorBox Stremio addon. Third party apps may still use this setting.\n \"stremio_seed_torrents\": 0, // 1 = Auto, 2 = Always, 3 = Never\n \"seed_torrents\": 0, // 1 = Auto, 2 = Always, 3 = Never\n \"allow_zipped\": true,\n \"stremio_allow_zipped\": true,\n \"onefichier_folder_id\": \"string\",\n \"gofile_folder_id\": \"string\",\n \"jdownloader_notifications\": true,\n \"webhook_notifications\": true,\n \"webhook_url\": \"string\",\n \"telegram_notifications\": true,\n \"telegram_id\": \"string\",\n \"mega_email\": \"string\",\n \"mega_password\": \"string\",\n \"stremio_sort\": \"string\", // seeders = Seeders/Age (highest seeders first/lowest age first), size = Size (highest size first), resolution = Resolution (highest resolution first)\n \"cdn_selection\": \"string\", // any available CDN. Can be found using test file route\n \"stremio_use_custom_search_engines\": true,\n \"stremio_result_sort\": \"string\", // torrents = Torrents first, usenet = Usenet first\n \"webdav_use_local_files\": true, \n \"stremio_legacy_your_media\": true,\n \"stremio_only_your_media_streams\": true, // only shows Your Media streams in Stremio addon\n \"stremio_disable_your_media_streams\": true,\n \"webdav_use_folder_view\": true,\n \"webdav_flatten\": true,\n \"stremio_limit_per_resolution_torrent\": 0,\n \"stremio_limit_per_resolution_usenet\": 0,\n \"stremio_size_upper\": 0,\n \"stremio_torrent_seeders_cutoff\": 0,\n \"pixeldrain_api_key\": \"string\",\n \"onefichier_api_key\": \"string\",\n \"gofile_api_key\": \"string\",\n \"patreon_id\": \"string\",\n \"stremio_wait_for_download_usenet\": true,\n \"stremio_wait_for_download_torrent\": true,\n \"stremio_disable_filtered_note\": true,\n \"stremio_emoji_in_description\": true,\n \"dashboard_filter\": { // sorts the user's dashboard. Does not affect third party dashboards. This entire dict MUST be presented with all keys for any update to be given.\n \"torrents\": false,\n \"usenet_downloads\": false,\n \"web_downloads\": false,\n \"active\": false,\n \"inactive\": false,\n \"queued\": false,\n \"downloading\": false,\n \"uploading\": false,\n \"processing\": false,\n \"download_ready\": false,\n \"cached\": false,\n \"uncached\": false,\n \"private\": false,\n \"borrowed\": false\n },\n \"web_player_always_transcode\": true,\n \"web_player_always_skip_intro\": true,\n \"web_player_audio_preferred_language\": \"string\",\n \"web_player_subtitle_preferred_language\": \"string\",\n \"web_player_disable_prestream_selector\": true,\n \"dashboard_sort\": \"string\", // default = TorBox default sorting, name = AZ sorting, size = largest size first, added_date = newest first, cached_date = newest first, last_updated = newest first, progress = highest progress first, ratio = highest ratio first, download_speed = highest value first, upload_speed = highest value first, eta = smallest eta first\n \"web_player_disable_next_up_dialogue\": true,\n \"web_player_enable_scrobbling\": true,\n \"append_filename_to_links\": true\n}","options":{"raw":{"language":"json"}}},"url":"{{api_base}}/{{api_version}}/api/user/settings/editsettings"},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"BAD_TOKEN\",\n \"detail\": \"Your token is invalid or has expired. Please log in again or reset your token.\",\n \"data\": null\n}"}],"_postman_id":"263427ea-0129-4f59-a0e4-11ef3e9364f4"},{"name":"Get User Search Engines","id":"fbb2cd77-7dbf-4e73-913c-8544f7acedd0","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[],"url":"{{api_base}}/{{api_version}}/api/user/settings/searchengines?id","description":"Overview
\nGets all of user's configured search engines. This includes enabled, and disabled search engines. Can pass the \"id\" parameter to get a specific search engine if it exists on the user's account.
\nAuthorization
\nRequires an API key using the Authorization Bearer Header.
\n","urlObject":{"path":["{{api_version}}","api","user","settings","searchengines"],"host":["{{api_base}}"],"query":[{"description":{"content":"Retrieve a specific search engine if it is owned by the user and exists.
\n","type":"text/plain"},"key":"id","value":null}],"variable":[]}},"response":[{"id":"04fb9ca7-1015-4418-a3bb-3c65d014550d","name":"Success","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{api_base}}/{{api_version}}/api/user/settings/searchengines?id","host":["{{api_base}}"],"path":["{{api_version}}","api","user","settings","searchengines"],"query":[{"key":"id","value":null,"description":"Retrieve a specific search engine if it is owned by the user and exists."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n\t\"success\": true,\n\t\"error\": null,\n\t\"detail\": \"Successfully retrieved user search engines.\",\n\t\"data\": [\n\t\t{\n\t\t\t\"id\": 0,\n\t\t\t\"created_at\": \"2025-02-12T23:14:17Z\",\n\t\t\t\"auth_id\": \"string\",\n\t\t\t\"type\": \"string\",\n\t\t\t\"url\": \"http://xxxx\",\n\t\t\t\"apikey\": \"string\",\n\t\t\t\"active\": true,\n\t\t\t\"valid\": false,\n\t\t\t\"download_type\": \"string\",\n\t\t\t\"indexers\": [\n \"string\"\n ]\n\t\t}\n\t]\n}"},{"id":"ae7c9f49-fc8a-4644-8698-73d722767fec","name":"Success ID","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{api_base}}/{{api_version}}/api/user/settings/searchengines?id=0","host":["{{api_base}}"],"path":["{{api_version}}","api","user","settings","searchengines"],"query":[{"key":"id","value":"0","description":"Retrieve a specific search engine if it is owned by the user and exists."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n\t\"success\": true,\n\t\"error\": null,\n\t\"detail\": \"Successfully retrieved user search engines.\",\n\t\"data\": {\n \"id\": 0,\n \"created_at\": \"2025-02-12T23:14:17Z\",\n \"auth_id\": \"string\",\n \"type\": \"string\",\n \"url\": \"http://xxxx\",\n \"apikey\": \"string\",\n \"active\": true,\n \"valid\": false,\n \"download_type\": \"string\",\n \"indexers\": [\n \"string\"\n ]\n }\n}"},{"id":"6b9cc06d-0319-45c2-ab15-c48f7260f5de","name":"Fail ITEM_NOT_FOUND","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{api_base}}/{{api_version}}/api/user/settings/searchengines?id=999","host":["{{api_base}}"],"path":["{{api_version}}","api","user","settings","searchengines"],"query":[{"key":"id","value":"999","description":"Retrieve a specific search engine if it is owned by the user and exists."}]}},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"ITEM_NOT_FOUND\",\n \"detail\": \"The search engine you are trying to edit does not exist.\",\n \"data\": null\n}"},{"id":"4e5c7402-9f90-472a-be99-9a6c8dc282c8","name":"Fail DATABASE_ERROR","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{api_base}}/{{api_version}}/api/user/settings/searchengines?id","host":["{{api_base}}"],"path":["{{api_version}}","api","user","settings","searchengines"],"query":[{"key":"id","value":null,"description":"Retrieve a specific search engine if it is owned by the user and exists."}]}},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"DATABASE_ERROR\",\n \"detail\": \"An unknown error occurred. Please try again later.\",\n \"data\": null\n}"},{"id":"b0af84a8-8ee9-4bef-af16-98957d86c0b5","name":"Fail UNKNOWN_ERROR","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{api_base}}/{{api_version}}/api/user/settings/searchengines?id","host":["{{api_base}}"],"path":["{{api_version}}","api","user","settings","searchengines"],"query":[{"key":"id","value":null,"description":"Retrieve a specific search engine if it is owned by the user and exists."}]}},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"UNKNOWN_ERROR\",\n \"detail\": \"There was an error retrieving your search engines. Please try again later.\",\n \"data\": null\n}"},{"id":"0a7ef6b0-53d9-4d6c-86cc-cbfd7578f81b","name":"Fail AUTH_ERROR","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{api_base}}/{{api_version}}/api/user/settings/searchengines?id","host":["{{api_base}}"],"path":["{{api_version}}","api","user","settings","searchengines"],"query":[{"key":"id","value":null,"description":"Retrieve a specific search engine if it is owned by the user and exists."}]}},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"AUTH_ERROR\",\n \"detail\": \"There was an error verifying your API key. Please try again later.\",\n \"data\": null\n}"},{"id":"241f606b-d116-45ee-92cb-2ec19c3d329d","name":"Fail NO_AUTH","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{api_base}}/{{api_version}}/api/user/settings/searchengines?id","host":["{{api_base}}"],"path":["{{api_version}}","api","user","settings","searchengines"],"query":[{"key":"id","value":null,"description":"Retrieve a specific search engine if it is owned by the user and exists."}]}},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"detail\": \"Please provide a valid API token.\",\n \"error\": \"NO_AUTH\",\n \"data\": null\n}"},{"id":"b5e1539a-8ed1-4cb3-9b9f-0468732017ae","name":"Fail BAD_TOKEN","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{api_base}}/{{api_version}}/api/user/settings/searchengines?id","host":["{{api_base}}"],"path":["{{api_version}}","api","user","settings","searchengines"],"query":[{"key":"id","value":null,"description":"Retrieve a specific search engine if it is owned by the user and exists."}]}},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"BAD_TOKEN\",\n \"detail\": \"Your token is invalid or has expired. Please log in again or reset your token.\",\n \"data\": null\n}"}],"_postman_id":"fbb2cd77-7dbf-4e73-913c-8544f7acedd0"},{"name":"Control Search Engine","id":"828c7226-daad-4737-8ed5-98c9d5fa1089","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"operation\": \"string\", // enable, disable, check or delete\n \"id\": 0, // the ID of the search engine you want to run this operation on. Optional if providing the \"all\" body parameter\n \"all\": false // if you want to run this operation on all of the user's configured search engines. Optional if providing the \"id\" body parameter\n}","options":{"raw":{"language":"json"}}},"url":"{{api_base}}/{{api_version}}/api/user/settings/controlsearchengines","description":"Overview
\nControls a user's search engine(s). This allows you to run specific operations on a single or all your configured search engines.
\nOperations
\n- \n
enable - Enables a search engine(s)
\n \ndisable - Disables a search engine(s)
\n \ncheck - Immedately checks the validity of a search engine(s)
\n \ndelete - Deletes a search engine(s)
\n \n
Authorization
\nRequires an API key using the Authorization Bearer Header.
\n","urlObject":{"path":["{{api_version}}","api","user","settings","controlsearchengines"],"host":["{{api_base}}"],"query":[],"variable":[]}},"response":[{"id":"434661ef-d66f-4390-8d2e-3b9edd04b56d","name":"Success","originalRequest":{"method":"GET","header":[],"body":{"mode":"raw","raw":"{\n \"operation\": \"string\", // enable, disable or check\n \"id\": 0, // the ID of the search engine you want to run this operation on. Optional if providing the \"all\" body parameter\n \"all\": false // if you want to run this operation on all of the user's configured search engines. Optional if providing the \"id\" body parameter\n}","options":{"raw":{"language":"json"}}},"url":"{{api_base}}/{{api_version}}/api/user/settings/controlsearchengines"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"error\": null,\n \"detail\": \"Successfully operationd search engine.\",\n \"data\": null\n}"},{"id":"758d06a0-9948-4670-9e51-51090676be4c","name":"Fail DATABASE_ERROR","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"operation\": \"string\", // enable, disable or check\n \"id\": 0, // the ID of the search engine you want to run this operation on. Optional if providing the \"all\" body parameter\n \"all\": false // if you want to run this operation on all of the user's configured search engines. Optional if providing the \"id\" body parameter\n}","options":{"raw":{"language":"json"}}},"url":"{{api_base}}/{{api_version}}/api/user/settings/controlsearchengines"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"DATABASE_ERROR\",\n \"detail\": \"An unknown error occurred. Please try again later.\",\n \"data\": null\n}"},{"id":"2cf5ebe8-f3a3-4c92-ab5b-ad40b4615d23","name":"Fail ITEM_NOT_FOUND","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"operation\": \"string\", // enable, disable or check\n \"id\": 0, // the ID of the search engine you want to run this operation on. Optional if providing the \"all\" body parameter\n \"all\": false // if you want to run this operation on all of the user's configured search engines. Optional if providing the \"id\" body parameter\n}","options":{"raw":{"language":"json"}}},"url":"{{api_base}}/{{api_version}}/api/user/settings/controlsearchengines"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"ITEM_NOT_FOUND\",\n \"detail\": \"The search engine you are trying to control does not exist.\",\n \"data\": null\n}"},{"id":"2f5b469b-593f-4c56-8581-f1c3bb61ffce","name":"Fail UNKNOWN_ERROR","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"operation\": \"string\", // enable, disable or check\n \"id\": 0, // the ID of the search engine you want to run this operation on. Optional if providing the \"all\" body parameter\n \"all\": false // if you want to run this operation on all of the user's configured search engines. Optional if providing the \"id\" body parameter\n}","options":{"raw":{"language":"json"}}},"url":"{{api_base}}/{{api_version}}/api/user/settings/controlsearchengines"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"UNKNOWN_ERROR\",\n \"detail\": \"There was an error editing your search engine. Please try again later.\",\n \"data\": null\n}"},{"id":"4aa53fd6-ee45-412f-960b-b6655aa26c3a","name":"Fail AUTH_ERROR","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"operation\": \"string\", // enable, disable or check\n \"id\": 0, // the ID of the search engine you want to run this operation on. Optional if providing the \"all\" body parameter\n \"all\": false // if you want to run this operation on all of the user's configured search engines. Optional if providing the \"id\" body parameter\n}","options":{"raw":{"language":"json"}}},"url":"{{api_base}}/{{api_version}}/api/user/settings/controlsearchengines"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"AUTH_ERROR\",\n \"detail\": \"There was an error verifying your API key. Please try again later.\",\n \"data\": null\n}"},{"id":"b3c5c863-56bd-46f1-8dd5-4e1846c95456","name":"Fail NO_AUTH","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"operation\": \"string\", // enable, disable or check\n \"id\": 0, // the ID of the search engine you want to run this operation on. Optional if providing the \"all\" body parameter\n \"all\": false // if you want to run this operation on all of the user's configured search engines. Optional if providing the \"id\" body parameter\n}","options":{"raw":{"language":"json"}}},"url":"{{api_base}}/{{api_version}}/api/user/settings/controlsearchengines"},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"detail\": \"Please provide a valid API token.\",\n \"error\": \"NO_AUTH\",\n \"data\": null\n}"}],"_postman_id":"828c7226-daad-4737-8ed5-98c9d5fa1089"},{"name":"Edit Search Engine","id":"8979611e-5dae-4ee0-81dd-e1bf41570660","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"id\": 0, // The ID of the search engine you would like to modify\n \"type\": \"string\", // prowlarr, jackett, nzbhydra. The type of search engine that this is. Optional, will use the current type if not given.\n \"url\": \"string\", // The new URL of the search engine. Can be https. or http. Optional, will use the current type if not given.\n \"apikey\": \"string\", // The new API key of the search engine used for access. Optional, will use the current apikey if not given.\n \"download_type\": \"string\" // torrents, usenet. The type of search engine that this is. Optional, will use the current download_type if not given.\n}","options":{"raw":{"language":"json"}}},"url":"{{api_base}}/{{api_version}}/api/user/settings/modifysearchengines","description":"Overview
\nEdits a user's search engine according to the settings given.
\nAuthorization
\nRequires an API key using the Authorization Bearer Header.
\n","urlObject":{"path":["{{api_version}}","api","user","settings","modifysearchengines"],"host":["{{api_base}}"],"query":[],"variable":[]}},"response":[{"id":"55f11a21-ea3a-4ea0-a1c3-85ed418d8bdd","name":"Success","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"id\": 0, // The ID of the search engine you would like to modify\n \"type\": \"string\", // prowlarr, jackett, nzbhydra. The type of search engine that this is. Optional, will use the current type if not given.\n \"url\": \"string\", // The new URL of the search engine. Can be https. or http. Optional, will use the current type if not given.\n \"apikey\": \"string\", // The new API key of the search engine used for access. Optional, will use the current apikey if not given.\n \"download_type\": \"string\" // torrents, usenet. The type of search engine that this is. Optional, will use the current download_type if not given.\n}","options":{"raw":{"language":"json"}}},"url":"{{api_base}}/{{api_version}}/api/user/settings/modifysearchengines"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"error\": null,\n \"detail\": \"Successfully edited search engine.\",\n \"data\": {\n \"id\": 0,\n \"type\": \"string\",\n \"url\": \"string\",\n \"apikey\": \"string\",\n \"indexers\": [\n \"string\",\n \"string\"\n ],\n \"download_type\": \"string\"\n }\n}"},{"id":"4e62e81c-cce5-466a-8033-f26cbb5bb105","name":"Fail DATABASE_ERROR","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"id\": 0, // The ID of the search engine you would like to modify\n \"type\": \"string\", // prowlarr, jackett, nzbhydra. The type of search engine that this is. Optional, will use the current type if not given.\n \"url\": \"string\", // The new URL of the search engine. Can be https. or http. Optional, will use the current type if not given.\n \"apikey\": \"string\", // The new API key of the search engine used for access. Optional, will use the current apikey if not given.\n \"download_type\": \"string\" // torrents, usenet. The type of search engine that this is. Optional, will use the current download_type if not given.\n}","options":{"raw":{"language":"json"}}},"url":"{{api_base}}/{{api_version}}/api/user/settings/modifysearchengines"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"DATABASE_ERROR\",\n \"detail\": \"An unknown error occurred. Please try again later.\",\n \"data\": null\n}"},{"id":"be03a362-4e03-4f8c-910f-3f8278a9825a","name":"Fail INVALID_SEARCH_ENGINE","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"id\": 0, // The ID of the search engine you would like to modify\n \"type\": \"string\", // prowlarr, jackett, nzbhydra. The type of search engine that this is. Optional, will use the current type if not given.\n \"url\": \"string\", // The new URL of the search engine. Can be https. or http. Optional, will use the current type if not given.\n \"apikey\": \"string\", // The new API key of the search engine used for access. Optional, will use the current apikey if not given.\n \"download_type\": \"string\" // torrents, usenet. The type of search engine that this is. Optional, will use the current download_type if not given.\n}","options":{"raw":{"language":"json"}}},"url":"{{api_base}}/{{api_version}}/api/user/settings/modifysearchengines"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"INVALID_SEARCH_ENGINE\",\n \"detail\": \"Search engine provided is invalid. This may be due to an incorrect URL, wrong API key, or the URL not being reachable.\",\n \"data\": null\n}"},{"id":"f0f56e67-e68c-4fb9-aecf-aa8244b624f6","name":"Fail ITEM_NOT_FOUND","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"id\": 0, // The ID of the search engine you would like to modify\n \"type\": \"string\", // prowlarr, jackett, nzbhydra. The type of search engine that this is. Optional, will use the current type if not given.\n \"url\": \"string\", // The new URL of the search engine. Can be https. or http. Optional, will use the current type if not given.\n \"apikey\": \"string\", // The new API key of the search engine used for access. Optional, will use the current apikey if not given.\n \"download_type\": \"string\" // torrents, usenet. The type of search engine that this is. Optional, will use the current download_type if not given.\n}","options":{"raw":{"language":"json"}}},"url":"{{api_base}}/{{api_version}}/api/user/settings/modifysearchengines"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"ITEM_NOT_FOUND\",\n \"detail\": \"The search engine you are trying to edit does not exist.\",\n \"data\": null\n}"},{"id":"dd6b59b1-fafa-4c32-8596-5d4d99b2b4ec","name":"Fail UNKNOWN_ERROR","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"id\": 0, // The ID of the search engine you would like to modify\n \"type\": \"string\", // prowlarr, jackett, nzbhydra. The type of search engine that this is. Optional, will use the current type if not given.\n \"url\": \"string\", // The new URL of the search engine. Can be https. or http. Optional, will use the current type if not given.\n \"apikey\": \"string\", // The new API key of the search engine used for access. Optional, will use the current apikey if not given.\n \"download_type\": \"string\" // torrents, usenet. The type of search engine that this is. Optional, will use the current download_type if not given.\n}","options":{"raw":{"language":"json"}}},"url":"{{api_base}}/{{api_version}}/api/user/settings/modifysearchengines"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"UNKNOWN_ERROR\",\n \"detail\": \"There was an error editing your search engine. Please try again later.\",\n \"data\": null\n}"},{"id":"b34c88b4-c647-4584-b0fe-fb303f00cb25","name":"Fail AUTH_ERROR","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"id\": 0, // The ID of the search engine you would like to modify\n \"type\": \"string\", // prowlarr, jackett, nzbhydra. The type of search engine that this is. Optional, will use the current type if not given.\n \"url\": \"string\", // The new URL of the search engine. Can be https. or http. Optional, will use the current type if not given.\n \"apikey\": \"string\", // The new API key of the search engine used for access. Optional, will use the current apikey if not given.\n \"download_type\": \"string\" // torrents, usenet. The type of search engine that this is. Optional, will use the current download_type if not given.\n}","options":{"raw":{"language":"json"}}},"url":"{{api_base}}/{{api_version}}/api/user/settings/modifysearchengines"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"AUTH_ERROR\",\n \"detail\": \"There was an error verifying your API key. Please try again later.\",\n \"data\": null\n}"},{"id":"87c7ab9b-f90d-4cf5-afec-347d3feb7c23","name":"Fail NO_AUTH","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"id\": 0, // The ID of the search engine you would like to modify\n \"type\": \"string\", // prowlarr, jackett, nzbhydra. The type of search engine that this is. Optional, will use the current type if not given.\n \"url\": \"string\", // The new URL of the search engine. Can be https. or http. Optional, will use the current type if not given.\n \"apikey\": \"string\", // The new API key of the search engine used for access. Optional, will use the current apikey if not given.\n \"download_type\": \"string\" // torrents, usenet. The type of search engine that this is. Optional, will use the current download_type if not given.\n}","options":{"raw":{"language":"json"}}},"url":"{{api_base}}/{{api_version}}/api/user/settings/modifysearchengines"},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"detail\": \"Please provide a valid API token.\",\n \"error\": \"NO_AUTH\",\n \"data\": null\n}"},{"id":"7724a867-0e91-43de-96ac-c09c553e7364","name":"Fail BAD_TOKEN","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"id\": 0, // The ID of the search engine you would like to modify\n \"type\": \"string\", // prowlarr, jackett, nzbhydra. The type of search engine that this is. Optional, will use the current type if not given.\n \"url\": \"string\", // The new URL of the search engine. Can be https. or http. Optional, will use the current type if not given.\n \"apikey\": \"string\", // The new API key of the search engine used for access. Optional, will use the current apikey if not given.\n \"download_type\": \"string\" // torrents, usenet. The type of search engine that this is. Optional, will use the current download_type if not given.\n}","options":{"raw":{"language":"json"}}},"url":"{{api_base}}/{{api_version}}/api/user/settings/modifysearchengines"},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"BAD_TOKEN\",\n \"detail\": \"Your token is invalid or has expired. Please log in again or reset your token.\",\n \"data\": null\n}"}],"_postman_id":"8979611e-5dae-4ee0-81dd-e1bf41570660"},{"name":"Add Search Engine","id":"8a1c54fa-8485-4fc0-8b42-17cddd082967","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"PUT","header":[],"body":{"mode":"raw","raw":"{\n \"type\": \"string\", // prowlarr, jackett, nzbhydra. The type of search engine that this is. Optional, will use the current type if not given.\n \"url\": \"string\", // The new URL of the search engine. Can be https. or http. Optional, will use the current type if not given.\n \"apikey\": \"string\", // The new API key of the search engine used for access. Optional, will use the current apikey if not given.\n \"download_type\": \"string\" // torrents, usenet. The type of search engine that this is. Optional, will use the current download_type if not given.\n}","options":{"raw":{"language":"json"}}},"url":"{{api_base}}/{{api_version}}/api/user/settings/addsearchengines","description":"Overview
\nCreates a new search engine on a user's account. To be a success, the search engine must pass a few tests of the following:
\n- \n
URL must be accessible.
\n- \n
This means no additional basic authentication (such as Authelia) other than the given apikey (if necessary)
\n \nThis means our servers must not be blocked (for example by a DNS service like Cloudflare)
\n \n
\nThe given apikey must be valid for this server and authenticate the proper routes.
\n \nThe search engine URL, search engine type, and search engine download type must not already exist on the user's account.
\n- \n
- For example, you can't have 2 usenet nzbhydras using the same url. \n
\nThe search engine must return a list of indexers.
\n \n
The API is very good at telling you exactly the issue, but can sometimes be vague as it may not know exactly what is the issue. Unless there was a major overhaul of the app, any errors are on the client's end, so please do not open a support ticket regarding the addition of a search engine, as it is likely an issue with one of the above requirements.
\nAuthorization
\nRequires an API key using the Authorization Bearer Header.
\n","urlObject":{"path":["{{api_version}}","api","user","settings","addsearchengines"],"host":["{{api_base}}"],"query":[],"variable":[]}},"response":[{"id":"5a05a35c-a354-4695-b2e4-c6dff9a11e59","name":"Success","originalRequest":{"method":"PUT","header":[],"body":{"mode":"raw","raw":"{\n \"type\": \"string\", // prowlarr, jackett, nzbhydra. The type of search engine that this is. Optional, will use the current type if not given.\n \"url\": \"string\", // The new URL of the search engine. Can be https. or http. Optional, will use the current type if not given.\n \"apikey\": \"string\", // The new API key of the search engine used for access. Optional, will use the current apikey if not given.\n \"download_type\": \"string\" // torrents, usenet. The type of search engine that this is. Optional, will use the current download_type if not given.\n}","options":{"raw":{"language":"json"}}},"url":"{{api_base}}/{{api_version}}/api/user/settings/addsearchengines"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n\t\"success\": true,\n\t\"error\": null,\n\t\"detail\": \"Successfully added search engine.\",\n\t\"data\": [\n\t\t{\n\t\t\t\"id\": 0,\n\t\t\t\"type\": \"string\",\n\t\t\t\"url\": \"http://xxxx\",\n\t\t\t\"apikey\": \"string\",\n\t\t\t\"download_type\": \"string\",\n\t\t\t\"indexers\": [\n \"string\",\n \"string\"\n ]\n\t\t}\n\t]\n}"},{"id":"05219b29-a202-4931-9c18-fab1c8607cbf","name":"Fail INVALID_SEARCH_ENGINE","originalRequest":{"method":"PUT","header":[],"body":{"mode":"raw","raw":"{\n \"type\": \"string\", // prowlarr, jackett, nzbhydra. The type of search engine that this is. Optional, will use the current type if not given.\n \"url\": \"string\", // The new URL of the search engine. Can be https. or http. Optional, will use the current type if not given.\n \"apikey\": \"string\", // The new API key of the search engine used for access. Optional, will use the current apikey if not given.\n \"download_type\": \"string\" // torrents, usenet. The type of search engine that this is. Optional, will use the current download_type if not given.\n}","options":{"raw":{"language":"json"}}},"url":"{{api_base}}/{{api_version}}/api/user/settings/addsearchengines"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"INVALID_SEARCH_ENGINE\",\n \"detail\": \"Search engine provided is invalid. This may be due to an incorrect URL, wrong API key, or the URL not being reachable.\",\n \"data\": null\n}"},{"id":"18fdfe24-9393-43e1-b868-a4ac66768dae","name":"Fail DATABASE_ERROR","originalRequest":{"method":"PUT","header":[],"body":{"mode":"raw","raw":"{\n \"type\": \"string\", // prowlarr, jackett, nzbhydra. The type of search engine that this is. Optional, will use the current type if not given.\n \"url\": \"string\", // The new URL of the search engine. Can be https. or http. Optional, will use the current type if not given.\n \"apikey\": \"string\", // The new API key of the search engine used for access. Optional, will use the current apikey if not given.\n \"download_type\": \"string\" // torrents, usenet. The type of search engine that this is. Optional, will use the current download_type if not given.\n}","options":{"raw":{"language":"json"}}},"url":"{{api_base}}/{{api_version}}/api/user/settings/addsearchengines"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"DATABASE_ERROR\",\n \"detail\": \"An unknown error occurred. Please try again later.\",\n \"data\": null\n}"},{"id":"b6591c0f-4683-44b6-a004-49b72bcfa8aa","name":"Fail SEARCH_ENGINE_EXISTS","originalRequest":{"method":"PUT","header":[],"body":{"mode":"raw","raw":"{\n \"type\": \"string\", // prowlarr, jackett, nzbhydra. The type of search engine that this is. Optional, will use the current type if not given.\n \"url\": \"string\", // The new URL of the search engine. Can be https. or http. Optional, will use the current type if not given.\n \"apikey\": \"string\", // The new API key of the search engine used for access. Optional, will use the current apikey if not given.\n \"download_type\": \"string\" // torrents, usenet. The type of search engine that this is. Optional, will use the current download_type if not given.\n}","options":{"raw":{"language":"json"}}},"url":"{{api_base}}/{{api_version}}/api/user/settings/addsearchengines"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"SEARCH_ENGINE_EXISTS\",\n \"detail\": \"You already have this exact search engine added.\",\n \"data\": null\n}"},{"id":"009e1ff2-1c0d-43c1-8df3-5a811ae7d5a4","name":"Fail UNKNOWN_ERROR","originalRequest":{"method":"PUT","header":[],"body":{"mode":"raw","raw":"{\n \"type\": \"string\", // prowlarr, jackett, nzbhydra. The type of search engine that this is. Optional, will use the current type if not given.\n \"url\": \"string\", // The new URL of the search engine. Can be https. or http. Optional, will use the current type if not given.\n \"apikey\": \"string\", // The new API key of the search engine used for access. Optional, will use the current apikey if not given.\n \"download_type\": \"string\" // torrents, usenet. The type of search engine that this is. Optional, will use the current download_type if not given.\n}","options":{"raw":{"language":"json"}}},"url":"{{api_base}}/{{api_version}}/api/user/settings/addsearchengines"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"UNKNOWN_ERROR\",\n \"detail\": \"There was an error adding your search engine. Please try again later.\",\n \"data\": null\n}"},{"id":"6c787e24-651c-4ca5-b22e-a01111141c76","name":"Fail AUTH_ERROR","originalRequest":{"method":"PUT","header":[],"body":{"mode":"raw","raw":"{\n \"type\": \"string\", // prowlarr, jackett, nzbhydra. The type of search engine that this is. Optional, will use the current type if not given.\n \"url\": \"string\", // The new URL of the search engine. Can be https. or http. Optional, will use the current type if not given.\n \"apikey\": \"string\", // The new API key of the search engine used for access. Optional, will use the current apikey if not given.\n \"download_type\": \"string\" // torrents, usenet. The type of search engine that this is. Optional, will use the current download_type if not given.\n}","options":{"raw":{"language":"json"}}},"url":"{{api_base}}/{{api_version}}/api/user/settings/addsearchengines"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"AUTH_ERROR\",\n \"detail\": \"There was an error verifying your API key. Please try again later.\",\n \"data\": null\n}"},{"id":"cd25e45f-a792-4983-8ebe-3d6d5800f441","name":"Fail NO_AUTH","originalRequest":{"method":"PUT","header":[],"body":{"mode":"raw","raw":"{\n \"type\": \"string\", // prowlarr, jackett, nzbhydra. The type of search engine that this is. Optional, will use the current type if not given.\n \"url\": \"string\", // The new URL of the search engine. Can be https. or http. Optional, will use the current type if not given.\n \"apikey\": \"string\", // The new API key of the search engine used for access. Optional, will use the current apikey if not given.\n \"download_type\": \"string\" // torrents, usenet. The type of search engine that this is. Optional, will use the current download_type if not given.\n}","options":{"raw":{"language":"json"}}},"url":"{{api_base}}/{{api_version}}/api/user/settings/addsearchengines"},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"detail\": \"Please provide a valid API token.\",\n \"error\": \"NO_AUTH\",\n \"data\": null\n}"},{"id":"0c4c5196-0ced-493a-8cb9-6c283f77b874","name":"Fail BAD_TOKEN","originalRequest":{"method":"PUT","header":[],"body":{"mode":"raw","raw":"{\n \"type\": \"string\", // prowlarr, jackett, nzbhydra. The type of search engine that this is. Optional, will use the current type if not given.\n \"url\": \"string\", // The new URL of the search engine. Can be https. or http. Optional, will use the current type if not given.\n \"apikey\": \"string\", // The new API key of the search engine used for access. Optional, will use the current apikey if not given.\n \"download_type\": \"string\" // torrents, usenet. The type of search engine that this is. Optional, will use the current download_type if not given.\n}","options":{"raw":{"language":"json"}}},"url":"{{api_base}}/{{api_version}}/api/user/settings/addsearchengines"},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"BAD_TOKEN\",\n \"detail\": \"Your token is invalid or has expired. Please log in again or reset your token.\",\n \"data\": null\n}"}],"_postman_id":"8a1c54fa-8485-4fc0-8b42-17cddd082967"}],"id":"6c220fed-b3b9-4aa0-9f35-12d17a76fcc5","description":"Overview
\nThis is the way to identify TorBox user's as well as get information about the user you are working with. This data contains important endpoints that allow you to control and view data on the account.
\nAuthorization
\nFor all requests, you will need your API token which can be found on your TorBox settings page under the API key section. Simply copy or refresh the API token and use it in the API. Some requests may require a session_token which you can find in the local storage of your browser on any TorBox.app page.
Device Code Flow
\nThe device code flow is used for obtaining a user's API token in an easy and simple fashion without requiring a user to type in the long API tokens into TV or other similar devices. This can make authorization into your app much simpler and user-friendly.
\n- \n
First start the flow by sending a
\nGETrequest to/auth/device/start, with your app in theappparameter.- \n
This will return all the necessary information.
\n- \n
\ndevice_code, which your app will use for consecutive requests later in the process. \n
\ncodewhich you will show to the user to be entered at the verification_url. \n
\nverification_url, which you will show as a QR code or direct link for them to go to. \n
\nMake sure to include your app name in the
\nappparameter of the request so the user clearly understands what they are linking to.- \n
- This app name only allows alpha-numeric characters for user-safety. \n
\nThese requests are only valid for 10 minutes, make sure the user is aware of this time limit.
\n \n
\nOnce you have started the process, the user will be asked to go to the
\nverification_urlto login and enter the code.- \n
It is expected that you show the
\nverification_urlas a QR code or thefriendly_verification_urlas a direct URL for the user to enter.- \n
- The
friendly_verification_urldoes not include your app name, as it is expected to be short and easy to type in. It will simply say \"Third Party App\". \n
\n- The
Do not redirect to this
\nverification_url, ie: put your own domain in front of it.- \n
- If you need a short URL, use the
friendly_verification_url. \n
\n- If you need a short URL, use the
The code must be visible to the user and large enough to see from a distance.
\n\n \nAll codes are 6 digit integers for simplicity.
\n \nFree users are not able to use this endpoint. They will be shown an error when attempting to verify this code.
\n \nInstructions should be simple and easy to follow.
\n \n
\nUse the
\nintervalin the/auth/device/startresponse to check if the user has authenticated the code by sendingPOSTrequests to/auth/device/tokenwith thedevice_codein the json body. This will return a400error (or use thesuccesskey) until the user has validated the code. Continuously poll this endpoint until it returns a success response. \nOnce the
\n/auth/device/tokenrequest returns a successful response, the user's API token will be included in the response json. This concludes the device code authorization flow. \n
![Plex](\"https://kagi.com/proxy/Plex_HTPC-3.png?c=-XuxjXfVBkjmWh0e6M3mu0Ja_qFalBU0EEtBzDSjCQnWWM0bVJqP3SaImMhGp7Ze1b95V_inIj8XPw1hRCXIBIV8CFUsgIn9iwV7js-C6YOCUnc5qarCDsNtHpIzt71_\"){kind=link}
![Disney+](\"https://kagi.com/proxy/disney-login-and-streaming-support-now-available-at-select-walt-disney-world-hotels-3.jpeg?c=H4fwbi1ywNt-hN8_-XoZobzEAioesspw-Cezkik4otwtH4-Sl542JrovwqGg5YgrkoztHQ5XZCb2v92aOfS29vk8yuzVlt2EZ5yvdmK2Du8QWn6HYJ3CoQSsUNv2F5gYBruzZvGx-RSAsxmQ9sBaBzZrQqypkL6doTQDYYrh_nQI-Jgm85VBI_lmgP62k80XA5qOY2-Ml1pWLuqoiKmYuA%3D%3D\"){kind=link}
Endpoints /api/user
\n- \n
\nPOSTRefresh API Token/refreshtoken\n
\nGETGet User Data/me\n
\nPOSTAdd Referral To Account/addreferral\n
\nGETGet Confirmation Code/getconfirmation\n
\nGETStart Device Code Authorization Process/auth/device/start\n
\nPOSTGet Token From Device Code Process/auth/device/token\n
Overview
\nAllows adding an RSS feed to your account. This API gives you a lot of customization options, but is best used with the UI on the website. This endpoint only works for Pro users (plan: 2).
\nAuthorization
\nRequires an API key using the Authorization Bearer Header.
\n","auth":{"type":"bearer","bearer":{"token":"{{api_key}}"},"isInherited":true,"source":{"_postman_id":"4244cdaf-ece6-4b6d-a2ca-463a3af48f54","id":"4244cdaf-ece6-4b6d-a2ca-463a3af48f54","name":"Main API","type":"collection"}},"urlObject":{"path":["{{api_version}}","api","rss","addrss"],"host":["{{api_base}}"],"query":[],"variable":[]}},"response":[{"id":"b745e797-360c-4ded-9162-51e67468d67f","name":"Success","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n\t\"url\": \"string\", // URL of the rss feed you want to add.\n\t\"name\": \"string\", // Display name of the rss feed you want to add.\n\t\"do_regex\": \"string\", // Regex of items you want to make sure are added. Optional.\n\t\"dont_regex\": \"string\", // Regex of items you dont want added. Optional.\n\t\"dont_older_than\": 0, // Time in days that tells the parser to skip if the torrent is older than that many days. Optional.\n\t\"scan_interval\": 0, // Time in minutes with the minimum being 10 which you want the api to scan in interval. Optional. Default is 60.\n\t\"pass_check\": false, // Boolean which tells to allow multiple of the same url if it already exists on your account\n\t\"rss_type\": \"torrent\", // The type of downloads inside of this RSS feed. Optional. Default is torrent. Options are \"torrent\", \"usenet\", \"webdl\"\n\t\"torrent_seeding\": 1 // Determines if torrents inside of this RSS feed will seed or not. Optional. Default is 1, for auto. Options are 1 for auto, 2 for always, and 3 for never.\n}","options":{"raw":{"language":"json"}}},"url":"{{api_base}}/{{api_version}}/api/rss/addrss"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"error\": null,\n \"detail\": \"RSS feed added successfully.\",\n \"data\": null\n}"},{"id":"d959ca1f-bb08-4f49-895a-7aeccdfe9790","name":"Fail PLAN_RESTRICTED_FEATURE","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n\t\"url\": \"string\", // URL of the rss feed you want to add.\n\t\"name\": \"string\", // Display name of the rss feed you want to add.\n\t\"do_regex\": \"string\", // Regex of items you want to make sure are added. Optional.\n\t\"dont_regex\": \"string\", // Regex of items you dont want added. Optional.\n\t\"dont_older_than\": 0, // Time in days that tells the parser to skip if the torrent is older than that many days. Optional.\n\t\"scan_interval\": 0, // Time in minutes with the minimum being 10 which you want the api to scan in interval. Optional. Default is 60.\n\t\"pass_check\": false, // Boolean which tells to allow multiple of the same url if it already exists on your account\n\t\"rss_type\": \"torrent\", // The type of downloads inside of this RSS feed. Optional. Default is torrent. Options are \"torrent\", \"usenet\", \"webdl\"\n\t\"torrent_seeding\": 1 // Determines if torrents inside of this RSS feed will seed or not. Optional. Default is 1, for auto. Options are 1 for auto, 2 for always, and 3 for never.\n}","options":{"raw":{"language":"json"}}},"url":"{{api_base}}/{{api_version}}/api/rss/addrss"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"PLAN_RESTRICTED_FEATURE\",\n \"detail\": \"You are not allowed to add RSS feeds. Please upgrade your plan.\",\n \"data\": null\n}"},{"id":"c166b477-6468-4c61-9382-d10c8a612381","name":"Fail DUPLICATE_ITEM","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n\t\"url\": \"string\", // URL of the rss feed you want to add.\n\t\"name\": \"string\", // Display name of the rss feed you want to add.\n\t\"do_regex\": \"string\", // Regex of items you want to make sure are added. Optional.\n\t\"dont_regex\": \"string\", // Regex of items you dont want added. Optional.\n\t\"dont_older_than\": 0, // Time in days that tells the parser to skip if the torrent is older than that many days. Optional.\n\t\"scan_interval\": 0, // Time in minutes with the minimum being 10 which you want the api to scan in interval. Optional. Default is 60.\n\t\"pass_check\": false, // Boolean which tells to allow multiple of the same url if it already exists on your account\n\t\"rss_type\": \"torrent\", // The type of downloads inside of this RSS feed. Optional. Default is torrent. Options are \"torrent\", \"usenet\", \"webdl\"\n\t\"torrent_seeding\": 1 // Determines if torrents inside of this RSS feed will seed or not. Optional. Default is 1, for auto. Options are 1 for auto, 2 for always, and 3 for never.\n}","options":{"raw":{"language":"json"}}},"url":"{{api_base}}/{{api_version}}/api/rss/addrss"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"DUPLICATE_ITEM\",\n \"detail\": \"RSS feed already exists.\",\n \"data\": null\n}"},{"id":"35a923f0-bbd0-44a0-ac1b-20b17b40b740","name":"Fail BOZO_RSS_FEED","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n\t\"url\": \"string\", // URL of the rss feed you want to add.\n\t\"name\": \"string\", // Display name of the rss feed you want to add.\n\t\"do_regex\": \"string\", // Regex of items you want to make sure are added. Optional.\n\t\"dont_regex\": \"string\", // Regex of items you dont want added. Optional.\n\t\"dont_older_than\": 0, // Time in days that tells the parser to skip if the torrent is older than that many days. Optional.\n\t\"scan_interval\": 0, // Time in minutes with the minimum being 10 which you want the api to scan in interval. Optional. Default is 60.\n\t\"pass_check\": false, // Boolean which tells to allow multiple of the same url if it already exists on your account\n\t\"rss_type\": \"torrent\", // The type of downloads inside of this RSS feed. Optional. Default is torrent. Options are \"torrent\", \"usenet\", \"webdl\"\n\t\"torrent_seeding\": 1 // Determines if torrents inside of this RSS feed will seed or not. Optional. Default is 1, for auto. Options are 1 for auto, 2 for always, and 3 for never.\n}","options":{"raw":{"language":"json"}}},"url":"{{api_base}}/{{api_version}}/api/rss/addrss"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"BOZO_RSS_FEED\",\n \"detail\": \"This RSS feed is not allowed. Please use a different URL.\",\n \"data\": null\n}"},{"id":"64ba7066-5b2b-45ea-80c1-5a4d0085cb72","name":"Fail DATABASE_ERROR","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n\t\"url\": \"string\", // URL of the rss feed you want to add.\n\t\"name\": \"string\", // Display name of the rss feed you want to add.\n\t\"do_regex\": \"string\", // Regex of items you want to make sure are added. Optional.\n\t\"dont_regex\": \"string\", // Regex of items you dont want added. Optional.\n\t\"dont_older_than\": 0, // Time in days that tells the parser to skip if the torrent is older than that many days. Optional.\n\t\"scan_interval\": 0, // Time in minutes with the minimum being 10 which you want the api to scan in interval. Optional. Default is 60.\n\t\"pass_check\": false, // Boolean which tells to allow multiple of the same url if it already exists on your account\n\t\"rss_type\": \"torrent\", // The type of downloads inside of this RSS feed. Optional. Default is torrent. Options are \"torrent\", \"usenet\", \"webdl\"\n\t\"torrent_seeding\": 1 // Determines if torrents inside of this RSS feed will seed or not. Optional. Default is 1, for auto. Options are 1 for auto, 2 for always, and 3 for never.\n}","options":{"raw":{"language":"json"}}},"url":"{{api_base}}/{{api_version}}/api/rss/addrss"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"DATABASE_ERROR\",\n \"detail\": \"There was a unknown error adding the RSS feed: ERROR. Please try again later.\",\n \"data\": null\n}"},{"id":"0e46e6e7-5229-4534-9500-81c8740e5972","name":"Fail AUTH_ERROR","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n\t\"url\": \"string\", // URL of the rss feed you want to add.\n\t\"name\": \"string\", // Display name of the rss feed you want to add.\n\t\"do_regex\": \"string\", // Regex of items you want to make sure are added. Optional.\n\t\"dont_regex\": \"string\", // Regex of items you dont want added. Optional.\n\t\"dont_older_than\": 0, // Time in days that tells the parser to skip if the torrent is older than that many days. Optional.\n\t\"scan_interval\": 0, // Time in minutes with the minimum being 10 which you want the api to scan in interval. Optional. Default is 60.\n\t\"pass_check\": false, // Boolean which tells to allow multiple of the same url if it already exists on your account\n\t\"rss_type\": \"torrent\", // The type of downloads inside of this RSS feed. Optional. Default is torrent. Options are \"torrent\", \"usenet\", \"webdl\"\n\t\"torrent_seeding\": 1 // Determines if torrents inside of this RSS feed will seed or not. Optional. Default is 1, for auto. Options are 1 for auto, 2 for always, and 3 for never.\n}","options":{"raw":{"language":"json"}}},"url":"{{api_base}}/{{api_version}}/api/rss/addrss"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"AUTH_ERROR\",\n \"detail\": \"There was an error verifying your API key. Please try again later.\",\n \"data\": null\n}"},{"id":"176a0d6f-14ac-4f09-b67d-5b315a9cfc52","name":"Fail NO_AUTH","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n\t\"url\": \"string\", // URL of the rss feed you want to add.\n\t\"name\": \"string\", // Display name of the rss feed you want to add.\n\t\"do_regex\": \"string\", // Regex of items you want to make sure are added. Optional.\n\t\"dont_regex\": \"string\", // Regex of items you dont want added. Optional.\n\t\"dont_older_than\": 0, // Time in days that tells the parser to skip if the torrent is older than that many days. Optional.\n\t\"scan_interval\": 0, // Time in minutes with the minimum being 10 which you want the api to scan in interval. Optional. Default is 60.\n\t\"pass_check\": false, // Boolean which tells to allow multiple of the same url if it already exists on your account\n\t\"rss_type\": \"torrent\", // The type of downloads inside of this RSS feed. Optional. Default is torrent. Options are \"torrent\", \"usenet\", \"webdl\"\n\t\"torrent_seeding\": 1 // Determines if torrents inside of this RSS feed will seed or not. Optional. Default is 1, for auto. Options are 1 for auto, 2 for always, and 3 for never.\n}","options":{"raw":{"language":"json"}}},"url":"{{api_base}}/{{api_version}}/api/rss/addrss"},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"detail\": \"Please provide a valid API token.\",\n \"error\": \"NO_AUTH\",\n \"data\": null\n}"},{"id":"ef6713ba-a66c-407f-be10-77a36e51955e","name":"Fail BAD_TOKEN","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n\t\"url\": \"string\", // URL of the rss feed you want to add.\n\t\"name\": \"string\", // Display name of the rss feed you want to add.\n\t\"do_regex\": \"string\", // Regex of items you want to make sure are added. Optional.\n\t\"dont_regex\": \"string\", // Regex of items you dont want added. Optional.\n\t\"dont_older_than\": 0, // Time in days that tells the parser to skip if the torrent is older than that many days. Optional.\n\t\"scan_interval\": 0, // Time in minutes with the minimum being 10 which you want the api to scan in interval. Optional. Default is 60.\n\t\"pass_check\": false, // Boolean which tells to allow multiple of the same url if it already exists on your account\n\t\"rss_type\": \"torrent\", // The type of downloads inside of this RSS feed. Optional. Default is torrent. Options are \"torrent\", \"usenet\", \"webdl\"\n\t\"torrent_seeding\": 1 // Determines if torrents inside of this RSS feed will seed or not. Optional. Default is 1, for auto. Options are 1 for auto, 2 for always, and 3 for never.\n}","options":{"raw":{"language":"json"}}},"url":"{{api_base}}/{{api_version}}/api/rss/addrss"},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"BAD_TOKEN\",\n \"detail\": \"Your token is invalid or has expired. Please log in again or reset your token.\",\n \"data\": null\n}"}],"_postman_id":"308901ab-cb21-424c-806d-f243d01f16dd"},{"name":"Control RSS Feed","id":"f89d49e9-4682-493d-a26b-591c8793ad13","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"token":"{{api_key}}"},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"operation\": \"string\", // The operation you want to perform on the RSS feed. Options are 'update', 'delete', 'resume' and 'pause'.\n \"rss_feed_id\": 0 // The ID of the RSS feed you want to perform the operation on.\n}","options":{"raw":{"language":"json"}}},"url":"{{api_base}}/{{api_version}}/api/rss/controlrss","description":"Overview
\nControls an RSS Feed. By sending the RSS feed's ID and the type of operation you want to perform, it will perform said action on the RSS feed checker.
\nOperations are either:
\n- \n
- Update
forces an update on the rss feed\n - Delete
deletes the rss feed from your account permanently. This also deletes all associated RSS feed items. This does not remove queued items spawned from the RSS feed.\n - Pause
pauses checking the rss feed on the scan interval\n - Resume
resumes a paused rss feed\n
Authorization
\nRequires an API key using the Authorization Bearer Header.
\n","urlObject":{"path":["{{api_version}}","api","rss","controlrss"],"host":["{{api_base}}"],"query":[],"variable":[]}},"response":[{"id":"25a476bc-9396-4f92-9de8-af3cb0f0ceee","name":"Success","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"operation\": \"string\", // The operation you want to perform on the RSS feed. Options are 'update', 'delete', 'resume' and 'pause'.\n \"rss_feed_id\": 0 // The ID of the RSS feed you want to perform the operation on.\n}","options":{"raw":{"language":"json"}}},"url":"{{api_base}}/{{api_version}}/api/rss/controlrss"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"error\": null,\n \"detail\": \"RSS Feed operationd successfully.\",\n \"data\": null\n}"},{"id":"0337fd18-7fa9-42ca-807b-6304afc18363","name":"Fail INVALID_OPTION","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"operation\": \"string\", // The operation you want to perform on the RSS feed. Options are 'update', 'delete', 'resume' and 'pause'.\n \"rss_feed_id\": 0 // The ID of the RSS feed you want to perform the operation on.\n}","options":{"raw":{"language":"json"}}},"url":"{{api_base}}/{{api_version}}/api/rss/controlrss"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"INVALID_OPTION\",\n \"detail\": \"Invalid operation. Please use one of the following: 'update', 'delete', 'resume', 'pause.\",\n \"data\": null\n}"},{"id":"015c1f22-eabd-4cba-9301-3006ab1d0610","name":"Fail DATABASE_ERROR","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"operation\": \"string\", // The operation you want to perform on the RSS feed. Options are 'update', 'delete', 'resume' and 'pause'.\n \"rss_feed_id\": 0 // The ID of the RSS feed you want to perform the operation on.\n}","options":{"raw":{"language":"json"}}},"url":"{{api_base}}/{{api_version}}/api/rss/controlrss"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"DATABASE_ERROR\",\n \"detail\": \"There was an error processing your request. Please try again later.\",\n \"data\": null\n}"},{"id":"69022063-d997-4fda-8677-2ed864fa3cdd","name":"Fail UNKNOWN_ERROR","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"operation\": \"string\", // The operation you want to perform on the RSS feed. Options are 'update', 'delete', 'resume' and 'pause'.\n \"rss_feed_id\": 0 // The ID of the RSS feed you want to perform the operation on.\n}","options":{"raw":{"language":"json"}}},"url":"{{api_base}}/{{api_version}}/api/rss/controlrss"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"UNKNOWN_ERROR\",\n \"detail\": \"There was an error processing your request. Please try again later.\",\n \"data\": null\n}"},{"id":"df8c9be7-1dda-4763-8787-1e7fea13f146","name":"Fail AUTH_ERROR","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"operation\": \"string\", // The operation you want to perform on the RSS feed. Options are 'update', 'delete', 'resume' and 'pause'.\n \"rss_feed_id\": 0 // The ID of the RSS feed you want to perform the operation on.\n}","options":{"raw":{"language":"json"}}},"url":"{{api_base}}/{{api_version}}/api/rss/controlrss"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"AUTH_ERROR\",\n \"detail\": \"There was an error verifying your API key. Please try again later.\",\n \"data\": null\n}"},{"id":"70549765-2d15-48a5-b499-e4242ff5ac18","name":"Fail NO_AUTH","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"operation\": \"string\", // The operation you want to perform on the RSS feed. Options are 'update', 'delete', 'resume' and 'pause'.\n \"rss_feed_id\": 0 // The ID of the RSS feed you want to perform the operation on.\n}","options":{"raw":{"language":"json"}}},"url":"{{api_base}}/{{api_version}}/api/rss/controlrss"},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"detail\": \"Please provide a valid API token.\",\n \"error\": \"NO_AUTH\",\n \"data\": null\n}"},{"id":"c69d9410-d599-4edd-8b59-7477c02dd2cf","name":"Fail BAD_TOKEN","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"operation\": \"string\", // The operation you want to perform on the RSS feed. Options are 'update', 'delete', 'resume' and 'pause'.\n \"rss_feed_id\": 0 // The ID of the RSS feed you want to perform the operation on.\n}","options":{"raw":{"language":"json"}}},"url":"{{api_base}}/{{api_version}}/api/rss/controlrss"},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"BAD_TOKEN\",\n \"detail\": \"Your token is invalid or has expired. Please log in again or reset your token.\",\n \"data\": null\n}"}],"_postman_id":"f89d49e9-4682-493d-a26b-591c8793ad13"},{"name":"Edit RSS Feed","id":"e69680e6-f21b-4613-ab70-80598b1ab838","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"rss_feed_id\": 0, // The ID of the RSS feed you want to modify.\n \"name\": \"string\", // Display name of the rss feed you want to add.\n \"do_regex\": \"string\", // Regex of items you want to make sure are added. Optional.\n \"dont_regex\": \"string\", // Regex of items you dont want added. Optional.\n \"dont_older_than\": 0, // Time in days that tells the parser to skip if the torrent is older than that many days. Optional.\n \"scan_interval\": 0, // Time in minutes with the minimum being 10 which you want the api to scan in interval. Optional. Default is 60.\n \"pass_check\": false, // Boolean which tells to allow multiple of the same url if it already exists on your account\n \"rss_type\": \"torrent\", // The type of downloads inside of this RSS feed. Optional. Default is torrent. Options are \"torrent\", \"usenet\", \"webdl\"\n \"torrent_seeding\": 1 // Determines if torrents inside of this RSS feed will seed or not. Optional. Default is 1, for auto. Options are 1 for auto, 2 for always, and 3 for never.\n}","options":{"raw":{"language":"json"}}},"url":"{{api_base}}/{{api_version}}/api/rss/modifyrss","description":"Overview
\nAllows you to edit the RSS feed based on the RSS feed ID passed. Allows you to change everything about an RSS feed, except for the URL.
\nWhen updating the \"rss_type\" or the \"torrent_seeding\" options, it will update all of the RSS items associated with the RSS feed, including all previous items.
\nAuthorization
\nRequires an API key using the Authorization Bearer Header.
\n","auth":{"type":"bearer","bearer":{"token":"{{api_key}}"},"isInherited":true,"source":{"_postman_id":"4244cdaf-ece6-4b6d-a2ca-463a3af48f54","id":"4244cdaf-ece6-4b6d-a2ca-463a3af48f54","name":"Main API","type":"collection"}},"urlObject":{"path":["{{api_version}}","api","rss","modifyrss"],"host":["{{api_base}}"],"query":[],"variable":[]}},"response":[{"id":"08c2a9d0-ced2-406b-bc65-7f204fa7c70f","name":"Success","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"rss_feed_id\": 0, // The ID of the RSS feed you want to modify.\n \"name\": \"string\", // Display name of the rss feed you want to add.\n \"do_regex\": \"string\", // Regex of items you want to make sure are added. Optional.\n \"dont_regex\": \"string\", // Regex of items you dont want added. Optional.\n \"dont_older_than\": 0, // Time in days that tells the parser to skip if the torrent is older than that many days. Optional.\n \"scan_interval\": 0, // Time in minutes with the minimum being 10 which you want the api to scan in interval. Optional. Default is 60.\n \"pass_check\": false, // Boolean which tells to allow multiple of the same url if it already exists on your account\n \"rss_type\": \"torrent\", // The type of downloads inside of this RSS feed. Optional. Default is torrent. Options are \"torrent\", \"usenet\", \"webdl\"\n \"torrent_seeding\": 1 // Determines if torrents inside of this RSS feed will seed or not. Optional. Default is 1, for auto. Options are 1 for auto, 2 for always, and 3 for never.\n}","options":{"raw":{"language":"json"}}},"url":"{{api_base}}/{{api_version}}/api/rss/modifyrss"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"error\": null,\n \"detail\": \"RSS feed modified successfully.\",\n \"data\": null\n}"},{"id":"8e736a72-d8e8-4815-9a9c-fa0cb36d3bea","name":"Fail BOZO_REGEX","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"rss_feed_id\": 0, // The ID of the RSS feed you want to modify.\n \"name\": \"string\", // Display name of the rss feed you want to add.\n \"do_regex\": \"string\", // Regex of items you want to make sure are added. Optional.\n \"dont_regex\": \"string\", // Regex of items you dont want added. Optional.\n \"dont_older_than\": 0, // Time in days that tells the parser to skip if the torrent is older than that many days. Optional.\n \"scan_interval\": 0, // Time in minutes with the minimum being 10 which you want the api to scan in interval. Optional. Default is 60.\n \"pass_check\": false, // Boolean which tells to allow multiple of the same url if it already exists on your account\n \"rss_type\": \"torrent\", // The type of downloads inside of this RSS feed. Optional. Default is torrent. Options are \"torrent\", \"usenet\", \"webdl\"\n \"torrent_seeding\": 1 // Determines if torrents inside of this RSS feed will seed or not. Optional. Default is 1, for auto. Options are 1 for auto, 2 for always, and 3 for never.\n}","options":{"raw":{"language":"json"}}},"url":"{{api_base}}/{{api_version}}/api/rss/modifyrss"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"BOZO_REGEX\",\n \"detail\": \"Invalid regex pattern.\",\n \"data\": null\n}"},{"id":"ecda2f66-b682-4c52-bd16-a22ba978d16b","name":"Fail INVALID_OPTION","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"rss_feed_id\": 0, // The ID of the RSS feed you want to modify.\n \"name\": \"string\", // Display name of the rss feed you want to add.\n \"do_regex\": \"string\", // Regex of items you want to make sure are added. Optional.\n \"dont_regex\": \"string\", // Regex of items you dont want added. Optional.\n \"dont_older_than\": 0, // Time in days that tells the parser to skip if the torrent is older than that many days. Optional.\n \"scan_interval\": 0, // Time in minutes with the minimum being 10 which you want the api to scan in interval. Optional. Default is 60.\n \"pass_check\": false, // Boolean which tells to allow multiple of the same url if it already exists on your account\n \"rss_type\": \"torrent\", // The type of downloads inside of this RSS feed. Optional. Default is torrent. Options are \"torrent\", \"usenet\", \"webdl\"\n \"torrent_seeding\": 1 // Determines if torrents inside of this RSS feed will seed or not. Optional. Default is 1, for auto. Options are 1 for auto, 2 for always, and 3 for never.\n}","options":{"raw":{"language":"json"}}},"url":"{{api_base}}/{{api_version}}/api/rss/modifyrss"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"INVALID_OPTION\",\n \"detail\": \"Scan interval must be at least 10 minutes.\",\n \"data\": null\n}"},{"id":"bed484d7-d6c1-4302-bedd-0526525c2b1c","name":"Fail UNKNOWN_ERROR","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"rss_feed_id\": 0, // The ID of the RSS feed you want to modify.\n \"name\": \"string\", // Display name of the rss feed you want to add.\n \"do_regex\": \"string\", // Regex of items you want to make sure are added. Optional.\n \"dont_regex\": \"string\", // Regex of items you dont want added. Optional.\n \"dont_older_than\": 0, // Time in days that tells the parser to skip if the torrent is older than that many days. Optional.\n \"scan_interval\": 0, // Time in minutes with the minimum being 10 which you want the api to scan in interval. Optional. Default is 60.\n \"pass_check\": false, // Boolean which tells to allow multiple of the same url if it already exists on your account\n \"rss_type\": \"torrent\", // The type of downloads inside of this RSS feed. Optional. Default is torrent. Options are \"torrent\", \"usenet\", \"webdl\"\n \"torrent_seeding\": 1 // Determines if torrents inside of this RSS feed will seed or not. Optional. Default is 1, for auto. Options are 1 for auto, 2 for always, and 3 for never.\n}","options":{"raw":{"language":"json"}}},"url":"{{api_base}}/{{api_version}}/api/rss/modifyrss"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"UNKNOWN_ERROR\",\n \"detail\": \"There was an error processing your request. Please try again later.\",\n \"data\": null\n}"},{"id":"939861fe-bc04-4a97-a81f-b01ea9f6acd5","name":"Fail AUTH_ERROR","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"rss_feed_id\": 0, // The ID of the RSS feed you want to modify.\n \"name\": \"string\", // Display name of the rss feed you want to add.\n \"do_regex\": \"string\", // Regex of items you want to make sure are added. Optional.\n \"dont_regex\": \"string\", // Regex of items you dont want added. Optional.\n \"dont_older_than\": 0, // Time in days that tells the parser to skip if the torrent is older than that many days. Optional.\n \"scan_interval\": 0, // Time in minutes with the minimum being 10 which you want the api to scan in interval. Optional. Default is 60.\n \"pass_check\": false, // Boolean which tells to allow multiple of the same url if it already exists on your account\n \"rss_type\": \"torrent\", // The type of downloads inside of this RSS feed. Optional. Default is torrent. Options are \"torrent\", \"usenet\", \"webdl\"\n \"torrent_seeding\": 1 // Determines if torrents inside of this RSS feed will seed or not. Optional. Default is 1, for auto. Options are 1 for auto, 2 for always, and 3 for never.\n}","options":{"raw":{"language":"json"}}},"url":"{{api_base}}/{{api_version}}/api/rss/modifyrss"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"AUTH_ERROR\",\n \"detail\": \"There was an error verifying your API key. Please try again later.\",\n \"data\": null\n}"},{"id":"45bff2f5-fc94-4f15-9075-3bcd6cd76f2d","name":"Fail NO_AUTH","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"rss_feed_id\": 0, // The ID of the RSS feed you want to modify.\n \"name\": \"string\", // Display name of the rss feed you want to add.\n \"do_regex\": \"string\", // Regex of items you want to make sure are added. Optional.\n \"dont_regex\": \"string\", // Regex of items you dont want added. Optional.\n \"dont_older_than\": 0, // Time in days that tells the parser to skip if the torrent is older than that many days. Optional.\n \"scan_interval\": 0, // Time in minutes with the minimum being 10 which you want the api to scan in interval. Optional. Default is 60.\n \"pass_check\": false, // Boolean which tells to allow multiple of the same url if it already exists on your account\n \"rss_type\": \"torrent\", // The type of downloads inside of this RSS feed. Optional. Default is torrent. Options are \"torrent\", \"usenet\", \"webdl\"\n \"torrent_seeding\": 1 // Determines if torrents inside of this RSS feed will seed or not. Optional. Default is 1, for auto. Options are 1 for auto, 2 for always, and 3 for never.\n}","options":{"raw":{"language":"json"}}},"url":"{{api_base}}/{{api_version}}/api/rss/modifyrss"},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"detail\": \"Please provide a valid API token.\",\n \"error\": \"NO_AUTH\",\n \"data\": null\n}"},{"id":"0fae40a1-050a-4190-a347-aa680d99499f","name":"Fail BAD_TOKEN","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"rss_feed_id\": 0, // The ID of the RSS feed you want to modify.\n \"name\": \"string\", // Display name of the rss feed you want to add.\n \"do_regex\": \"string\", // Regex of items you want to make sure are added. Optional.\n \"dont_regex\": \"string\", // Regex of items you dont want added. Optional.\n \"dont_older_than\": 0, // Time in days that tells the parser to skip if the torrent is older than that many days. Optional.\n \"scan_interval\": 0, // Time in minutes with the minimum being 10 which you want the api to scan in interval. Optional. Default is 60.\n \"pass_check\": false, // Boolean which tells to allow multiple of the same url if it already exists on your account\n \"rss_type\": \"torrent\", // The type of downloads inside of this RSS feed. Optional. Default is torrent. Options are \"torrent\", \"usenet\", \"webdl\"\n \"torrent_seeding\": 1 // Determines if torrents inside of this RSS feed will seed or not. Optional. Default is 1, for auto. Options are 1 for auto, 2 for always, and 3 for never.\n}","options":{"raw":{"language":"json"}}},"url":"{{api_base}}/{{api_version}}/api/rss/modifyrss"},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"BAD_TOKEN\",\n \"detail\": \"Your token is invalid or has expired. Please log in again or reset your token.\",\n \"data\": null\n}"}],"_postman_id":"e69680e6-f21b-4613-ab70-80598b1ab838"},{"name":"Get User RSS Feeds","id":"1624cad4-28fd-4bb0-934d-2246d1810cbc","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"token":"{{api_key}}"},"isInherited":false},"method":"GET","header":[],"url":"{{api_base}}/{{api_version}}/api/rss/getfeeds?id=","description":"Overview
\nGets all of a user's RSS feeds located on their account. Can only be accessed on a Pro (plan: 2) account. Also allows you to get a specific by passing an \"id\" in the parameters.
\nType Key
\nThe \"type\" key in the response is used for showing what type of downloads are spawned from this RSS feed. This affects how the item is downloaded, as well as what is scraped, so make sure it is correct.
\n- \n
- \"torrent\"
uses .torrent files and magnet links and adds as torrent when downloaded.\n - \"usenet\"
uses .nzb files and nzb links and adds as a usenet download when downloaded.\n - \"webdl\"
uses generic links and adds as a web download when downloaded.\n
Status Key
\nThe \"status\" key tells the user selected status of the RSS feed. These statuses are not the same as the status key for the RSS items associated with the RSS feed. Each feed also includes a \"status_message\" key which gives a user friendly message about anything about the RSS feed, such as errors and explainations.
\n- \n
\"active\"
\nthe RSS feed is set to be scraped.\n\"paused\"
\nthe RSS feed will not be scraped as it is paused by the user.\n\"error\"
\nthe RSS feed had an error while scraping, and cannot continue.\n
State Key
\nThe \"state\" key tells you exactly in real time, what the RSS feed is doing. This is useful for realtime status updates.
\n- \n
- \"idle\"
the RSS feed is idle, and is currently not doing anything in the current moment.\n - \"scraping\"
the RSS feed is currently scraping new RSS items.\n - \"downloading\"
the RSS feed is currently downloading the newly scraped RSS items.\n
Torrent Seeding Key
\nThe \"torrent_seeding\" key is returned with every response, regardless of the type of the RSS feed. This controls what seeding setting the RSS feed is using when it adds new torrents. These are the same options as when adding a torrent using the /torrent/createtorrent endpoint.
\n\n\nTells TorBox your preference for seeding this torrent. 1 is auto. 2 is seed. 3 is don't seed. Optional. Default is 1, or whatever the user has in their settings. Overwrites option in settings.
\n
- \n
- 1
auto, the torrent will seed based on what the user has in their settings.\n - 2
always, TorBox will be instructed to seed this torrent regardless of any other settings.\n - 3
never, TorBox will not seed this torrent.\n
Authorization
\nRequires an API key using the Authorization Bearer Header.
\n","urlObject":{"path":["{{api_version}}","api","rss","getfeeds"],"host":["{{api_base}}"],"query":[{"description":{"content":"A specific RSS feed ID that you want to retrieve. Optional.
\n","type":"text/plain"},"key":"id","value":""}],"variable":[]}},"response":[{"id":"d9400df5-09c0-4025-a8d6-835c77257461","name":"Success","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{api_base}}/{{api_version}}/api/rss/getfeeds?id=","host":["{{api_base}}"],"path":["{{api_version}}","api","rss","getfeeds"],"query":[{"key":"id","value":"","description":"A specific RSS feed ID that you want to retrieve. Optional."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n\t\"success\": true,\n\t\"error\": null,\n\t\"detail\": \"Successfully retrieved RSS feeds.\",\n\t\"data\": [\n\t\t{\n\t\t\t\"id\": 0,\n\t\t\t\"created_at\": \"2025-08-20T09:01:02.714060Z\",\n\t\t\t\"last_checked\": \"2026-03-09T20:40:22.457984Z\",\n\t\t\t\"auth_id\": \"string\",\n\t\t\t\"name\": \"string\",\n\t\t\t\"url\": \"https://xxxx\",\n\t\t\t\"source\": \"https://xxxx\",\n\t\t\t\"source_name\": \"string\",\n\t\t\t\"do_regex\": \"string\",\n\t\t\t\"dont_regex\": \"string\",\n\t\t\t\"status\": \"string\",\n\t\t\t\"scan_interval\": 0,\n\t\t\t\"dont_older_than\": 0,\n\t\t\t\"status_message\": \"string\",\n\t\t\t\"type\": \"string\",\n\t\t\t\"torrent_seeding\": 3,\n\t\t\t\"state\": \"string\"\n\t\t}\n\t]\n}"},{"id":"8ed4ab38-c766-4dda-a4d9-dfc1ec2e98d4","name":"Fail DATABASE_ERROR","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{api_base}}/{{api_version}}/api/rss/getfeeds?id=","host":["{{api_base}}"],"path":["{{api_version}}","api","rss","getfeeds"],"query":[{"key":"id","value":"","description":"A specific RSS feed ID that you want to retrieve. Optional."}]}},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"DATABASE_ERROR\",\n \"detail\": \"There was an error getting your RSS feeds. Please try again later.\",\n \"data\": null\n}"},{"id":"23c0a21d-2af6-4783-a74a-809542b09ba8","name":"Fail UNKNOWN_ERROR","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{api_base}}/{{api_version}}/api/rss/getfeeds?id=","host":["{{api_base}}"],"path":["{{api_version}}","api","rss","getfeeds"],"query":[{"key":"id","value":"","description":"A specific RSS feed ID that you want to retrieve. Optional."}]}},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"UNKNOWN_ERROR\",\n \"detail\": \"There was an error getting your RSS feeds. Please try again later.\",\n \"data\": null\n}"},{"id":"59120566-2b29-4978-a488-11ecbbb17100","name":"Fail AUTH_ERROR","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{api_base}}/{{api_version}}/api/rss/getfeeds?id=","host":["{{api_base}}"],"path":["{{api_version}}","api","rss","getfeeds"],"query":[{"key":"id","value":"","description":"A specific RSS feed ID that you want to retrieve. Optional."}]}},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"AUTH_ERROR\",\n \"detail\": \"There was an error verifying your API key. Please try again later.\",\n \"data\": null\n}"},{"id":"6053718f-3461-485d-bddc-15db1d234d84","name":"Fail NO_AUTH","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{api_base}}/{{api_version}}/api/rss/getfeeds?id=","host":["{{api_base}}"],"path":["{{api_version}}","api","rss","getfeeds"],"query":[{"key":"id","value":"","description":"A specific RSS feed ID that you want to retrieve. Optional."}]}},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"detail\": \"Please provide a valid API token.\",\n \"error\": \"NO_AUTH\",\n \"data\": null\n}"},{"id":"7b53eb19-dc82-4ae3-8f2d-17039b21fce5","name":"Fail BAD_TOKEN","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{api_base}}/{{api_version}}/api/rss/getfeeds?id=","host":["{{api_base}}"],"path":["{{api_version}}","api","rss","getfeeds"],"query":[{"key":"id","value":"","description":"A specific RSS feed ID that you want to retrieve. Optional."}]}},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"BAD_TOKEN\",\n \"detail\": \"Your token is invalid or has expired. Please log in again or reset your token.\",\n \"data\": null\n}"}],"_postman_id":"1624cad4-28fd-4bb0-934d-2246d1810cbc"},{"name":"Get RSS Feed Items","id":"5e2946d4-bfc8-4d0c-94c1-399c35b7cefa","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{api_base}}/{{api_version}}/api/rss/getfeeditems?rss_feed_id=","description":"Overview
\nGets the first 10,000 RSS feed items associated with an RSS feed. RSS feed items are scraped items from the RSS feed. They contain a direct download link as well as the content name, and additional information.
\nType Key
\nThe \"type\" key in the response is used for showing what type of downloads this RSS feed item is. This affects how the item is downloaded, as well as what is scraped, so make sure it is correct. When the parent RSS feed's type is changed, it changes all of the items types as well.
\n- \n
- \"torrent\"
uses .torrent files and magnet links and adds as torrent when downloaded.\n - \"usenet\"
uses .nzb files and nzb links and adds as a usenet download when downloaded.\n - \"webdl\"
uses generic links and adds as a web download when downloaded.\n
Status Key
\nThe \"status\" key tells the status of the RSS feed item. This is useful for seeing what the item is doing, and what it will do next. Each item also includes a \"status_message\" key which gives a user friendly message about anything about the RSS feed item, such as errors and explainations.
\n- \n
- \"new\"
the RSS feed item is set to be downloaded.\n - \"ignored\"
the RSS feed item has been ignored due to the parents RSS feed settings, as it doesn't match the chosen settings. The item will not be downloaded.\n - \"error\"
the RSS feed item had an error while attempting to download. The item will be retried on the next scrape.\n - \"downloaded\"
the RSS feed item has already been downloaded to the user's account. It will not be downloaded again.\n
Authorization
\nRequires an API key using the Authorization Bearer Header.
\n","auth":{"type":"bearer","bearer":{"token":"{{api_key}}"},"isInherited":true,"source":{"_postman_id":"4244cdaf-ece6-4b6d-a2ca-463a3af48f54","id":"4244cdaf-ece6-4b6d-a2ca-463a3af48f54","name":"Main API","type":"collection"}},"urlObject":{"path":["{{api_version}}","api","rss","getfeeditems"],"host":["{{api_base}}"],"query":[{"description":{"content":"The RSS Feed ID of the RSS Feed you want to retrieve the scraped items of.
\n","type":"text/plain"},"key":"rss_feed_id","value":""}],"variable":[]}},"response":[{"id":"d6156c80-18b6-4bb4-91b5-ceca77a782b1","name":"Success","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{api_base}}/{{api_version}}/api/rss/getfeeditems?rss_feed_id=","host":["{{api_base}}"],"path":["{{api_version}}","api","rss","getfeeditems"],"query":[{"key":"rss_feed_id","value":"","description":"The RSS Feed ID of the RSS Feed you want to retrieve the scraped items of."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"error\": null,\n \"detail\": \"Successfully retrieved RSS feed items.\",\n \"data\": [\n {\n \"id\": 0,\n \"created_at\": \"2026-03-10T02:30:13.149869Z\",\n \"rss_name\": \"string\",\n \"rss_url\": \"https://xxxx\",\n \"ignored\": false,\n \"downloaded\": true,\n \"link\": \"https://xxxx\",\n \"name\": \"string\",\n \"status\": \"string\",\n \"status_message\": \"string\",\n \"seed_torrents\": 0,\n \"type\": \"string\"\n }\n ]\n}"},{"id":"11dc360b-13ba-4a6a-a00b-b5d01fecc678","name":"Fail DATABASE_ERROR","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{api_base}}/{{api_version}}/api/rss/getfeeditems?rss_feed_id=","host":["{{api_base}}"],"path":["{{api_version}}","api","rss","getfeeditems"],"query":[{"key":"rss_feed_id","value":"","description":"The RSS Feed ID of the RSS Feed you want to retrieve the scraped items of."}]}},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"DATABASE_ERROR\",\n \"detail\": \"There was an error getting your RSS feeds. Please try again later.\",\n \"data\": null\n}"},{"id":"9c5410fa-43c1-45ce-90e9-d30b02770038","name":"Fail UNKNOWN_ERROR","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{api_base}}/{{api_version}}/api/rss/getfeeditems?rss_feed_id=","host":["{{api_base}}"],"path":["{{api_version}}","api","rss","getfeeditems"],"query":[{"key":"rss_feed_id","value":"","description":"The RSS Feed ID of the RSS Feed you want to retrieve the scraped items of."}]}},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"UNKNOWN_ERROR\",\n \"detail\": \"There was an error getting your RSS feeds. Please try again later.\",\n \"data\": null\n}"},{"id":"376c8782-c767-4b2a-891b-c5177746685a","name":"Fail AUTH_ERROR","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{api_base}}/{{api_version}}/api/rss/getfeeditems?rss_feed_id=","host":["{{api_base}}"],"path":["{{api_version}}","api","rss","getfeeditems"],"query":[{"key":"rss_feed_id","value":"","description":"The RSS Feed ID of the RSS Feed you want to retrieve the scraped items of."}]}},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"AUTH_ERROR\",\n \"detail\": \"There was an error verifying your API key. Please try again later.\",\n \"data\": null\n}"},{"id":"86361cb9-e803-4b90-8ab8-da88bba32193","name":"Fail NO_AUTH","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{api_base}}/{{api_version}}/api/rss/getfeeditems?rss_feed_id=","host":["{{api_base}}"],"path":["{{api_version}}","api","rss","getfeeditems"],"query":[{"key":"rss_feed_id","value":"","description":"The RSS Feed ID of the RSS Feed you want to retrieve the scraped items of."}]}},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"detail\": \"Please provide a valid API token.\",\n \"error\": \"NO_AUTH\",\n \"data\": null\n}"},{"id":"ebb33c5e-6062-4f50-bb90-c766da4384c9","name":"Fail BAD_TOKEN","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{api_base}}/{{api_version}}/api/rss/getfeeditems?rss_feed_id=","host":["{{api_base}}"],"path":["{{api_version}}","api","rss","getfeeditems"],"query":[{"key":"rss_feed_id","value":"","description":"The RSS Feed ID of the RSS Feed you want to retrieve the scraped items of."}]}},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"BAD_TOKEN\",\n \"detail\": \"Your token is invalid or has expired. Please log in again or reset your token.\",\n \"data\": null\n}"}],"_postman_id":"5e2946d4-bfc8-4d0c-94c1-399c35b7cefa"}],"id":"dd6b7b7b-3a75-4ed5-bb1f-560e63ab2e08","description":"Overview
\nFor Pro Users you can add RSS feeds which automate adding torrents to your TorBox. If you TorBox becomes full, the torrent will be queued and added at the first chance it gets. Along with adding RSS feeds you are able to control RSS feeds as well as modify existing ones.
\nAuthorization
\nFor all requests, you will need your API token which can be found on your TorBox settings page under the API key section. Simply copy or refresh the API token and use it in the API.
\nEndpoints /api/rss
\n- \n
\nPOSTAdd RSS Feed/addrss\n
\nPOSTControl RSS Feed/controlrss\n
\nPOSTModify RSS Feed/modifyrss\n
\nGETGet User RSS Feeds/getfeeds\n
\nGETGet RSS Feed Items/getfeeditems\n
Overview
\nGets all the jobs attached to a user account. This is good for an overall view of the jobs, such as on a dashboard, or something similar.
\nStatuses
\n- \n
\"pending\" -> Upload is still waiting in the queue. Waiting for spot to upload.
\n \n\"uploading\" -> Upload is uploading to the proper remote. Progress will be updated as upload continues.
\n \n\"completed\" -> Upload has successfully been uploaded. Progress will be at 1, and the download URL will be populated.
\n \n\"failed\" -> The upload has failed. Check the Detail key for information.
\n \n
Authorization
\nRequires an API key using the Authorization Bearer Header.
\n","auth":{"type":"bearer","bearer":{"token":"{{api_key}}"},"isInherited":true,"source":{"_postman_id":"4244cdaf-ece6-4b6d-a2ca-463a3af48f54","id":"4244cdaf-ece6-4b6d-a2ca-463a3af48f54","name":"Main API","type":"collection"}},"urlObject":{"path":["{{api_version}}","api","integration","jobs"],"host":["{{api_base}}"],"query":[],"variable":[]}},"response":[{"id":"955ab038-959e-4aa8-9f6c-cd24880d3ba7","name":"Success","originalRequest":{"method":"GET","header":[],"url":"{{api_base}}/{{api_version}}/api/integration/jobs"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n\t\"success\": true,\n \"error\": null,\n\t\"detail\": \"Jobs retrieved successfully.\",\n\t\"data\": [\n\t\t{\n\t\t\t\"id\": 0,\n\t\t\t\"created_at\": \"2024-06-13T07:51:12.40135+00:00\",\n\t\t\t\"updated_at\": \"2024-06-13T07:51:22.21287+00:00\",\n\t\t\t\"auth_id\": \"string\",\n\t\t\t\"hash\": \"string\",\n\t\t\t\"type\": \"string\",\n\t\t\t\"integration\": \"string\",\n\t\t\t\"file_id\": 0,\n\t\t\t\"zip\": false,\n\t\t\t\"progress\": 1,\n\t\t\t\"detail\": \"string\",\n\t\t\t\"download_url\": \"https://xxxx\",\n\t\t\t\"status\": \"string\",\n \"file_name\": \"string\",\n \"task_id\": \"string\"\n\t\t}\n\t]\n}"},{"id":"de4f1263-708d-4f2b-8520-8e27e83a896e","name":"Fail UNKNOWN_ERROR","originalRequest":{"method":"GET","header":[],"url":"{{api_base}}/{{api_version}}/api/integration/jobs"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"UNKNOWN_ERROR\",\n \"detail\": \"There was an error getting the jobs.\",\n \"data\": null\n}"},{"id":"7a4f252a-a561-4285-928e-cd1eeda924c8","name":"Fail AUTH_ERROR","originalRequest":{"method":"GET","header":[],"url":"{{api_base}}/{{api_version}}/api/integration/jobs"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"AUTH_ERROR\",\n \"detail\": \"There was an error verifying your API key. Please try again later.\",\n \"data\": null\n}"},{"id":"4654ff0c-3ad3-44fd-b86f-4fae4a743d90","name":"Fail NO_AUTH","originalRequest":{"method":"GET","header":[],"url":"{{api_base}}/{{api_version}}/api/integration/jobs"},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"detail\": \"Please provide a valid API token.\",\n \"error\": \"NO_AUTH\",\n \"data\": null\n}"},{"id":"23ee33f5-2f69-4494-853f-5af3bcac0087","name":"Fail BAD_TOKEN","originalRequest":{"method":"GET","header":[],"url":"{{api_base}}/{{api_version}}/api/integration/jobs"},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"BAD_TOKEN\",\n \"detail\": \"Your token is invalid or has expired. Please log in again or reset your token.\",\n \"data\": null\n}"}],"_postman_id":"76b327e6-8bfd-4c45-a99b-0cee435f084f"},{"name":"Get Specific Job","id":"07a30808-e06d-4e87-a38f-2595a9ae2bc4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{api_base}}/{{api_version}}/api/integration/job/{{job_id}}","description":"Overview
\nGets a specifc job using the Job's ID. To get the ID, you will have to Get All Jobs, and get the ID you want.
\nStatuses
\n- \n
- \"pending\" -> Upload is still waiting in the queue. Waiting for spot to upload. \n
- \"uploading\" -> Upload is uploading to the proper remote. Progress will be updated as upload continues. \n
- \"completed\" -> Upload has successfully been uploaded. Progress will be at 1, and the download URL will be populated. \n
- \"failed\" -> The upload has failed. Check the Detail key for information. \n
Authorization
\nRequires an API key using the Authorization Bearer Header.
\n","auth":{"type":"bearer","bearer":{"token":"{{api_key}}"},"isInherited":true,"source":{"_postman_id":"4244cdaf-ece6-4b6d-a2ca-463a3af48f54","id":"4244cdaf-ece6-4b6d-a2ca-463a3af48f54","name":"Main API","type":"collection"}},"urlObject":{"path":["{{api_version}}","api","integration","job","{{job_id}}"],"host":["{{api_base}}"],"query":[],"variable":[]}},"response":[{"id":"454beb54-8b45-42df-90f4-a729dc55ddb9","name":"Success","originalRequest":{"method":"GET","header":[],"url":"{{api_base}}/{{api_version}}/api/integration/job/{{job_id}}"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"error\": null,\n \"detail\": \"Job status retrieved successfully.\",\n \"data\": \n {\n \"id\": 0,\n \"created_at\": \"2024-06-13T07:51:12.40135+00:00\",\n \"updated_at\": \"2024-06-13T07:51:22.21287+00:00\",\n \"auth_id\": \"string\",\n \"hash\": \"string\",\n \"type\": \"torrent\",\n \"integration\": \"string\",\n \"file_id\": 0,\n \"zip\": false,\n \"progress\": 1,\n \"detail\": \"string\",\n \"download_url\": \"https://xxxx\",\n \"status\": \"string\",\n \"file_name\": \"string\",\n \"job_id\": \"string\"\n }\n}"},{"id":"91c5e42a-ffc3-4c70-8ea8-18594ed36069","name":"Fail ITEM_NOT_FOUND","originalRequest":{"method":"GET","header":[],"url":"{{api_base}}/{{api_version}}/api/integration/job/{{job_id}}"},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"ITEM_NOT_FOUND\",\n \"detail\": \"No job found.\",\n \"data\": null\n}"},{"id":"d653b97a-6f61-4efe-bf92-9017af09a6d6","name":"Fail UNKNOWN_ERROR","originalRequest":{"method":"GET","header":[],"url":"{{api_base}}/{{api_version}}/api/integration/job/{{job_id}}"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"UNKNOWN_ERROR\",\n \"detail\": \"There was an error getting the job status.\",\n \"data\": null\n}"},{"id":"9a138103-1e9b-404c-ae7a-e09ec4299c6c","name":"Fail AUTH_ERROR","originalRequest":{"method":"GET","header":[],"url":"{{api_base}}/{{api_version}}/api/integration/job/{{job_id}}"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"AUTH_ERROR\",\n \"detail\": \"There was an error verifying your API key. Please try again later.\",\n \"data\": null\n}"},{"id":"7d69662a-62fb-42ef-877f-fd99a201dd8c","name":"Fail NO_AUTH","originalRequest":{"method":"GET","header":[],"url":"{{api_base}}/{{api_version}}/api/integration/job/{{job_id}}"},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"detail\": \"Please provide a valid API token.\",\n \"error\": \"NO_AUTH\",\n \"data\": null\n}"},{"id":"ce9bf9cc-96fc-45f7-ace4-d4cb5630c6d4","name":"Fail BAD_TOKEN","originalRequest":{"method":"GET","header":[],"url":"{{api_base}}/{{api_version}}/api/integration/job/{{job_id}}"},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"BAD_TOKEN\",\n \"detail\": \"Your token is invalid or has expired. Please log in again or reset your token.\",\n \"data\": null\n}"}],"_postman_id":"07a30808-e06d-4e87-a38f-2595a9ae2bc4"},{"name":"Get All Jobs By Hash","id":"9c3f2993-efcc-46a2-8d39-da5e774f8b5b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{api_base}}/{{api_version}}/api/integration/jobs/{{hash}}","description":"Overview
\nGets all jobs that match a specific hash. Good for checking on specific downloads such as a download page, that could contain a lot of jobs.
\nStatuses
\n- \n
- \"pending\" -> Upload is still waiting in the queue. Waiting for spot to upload. \n
- \"uploading\" -> Upload is uploading to the proper remote. Progress will be updated as upload continues. \n
- \"completed\" -> Upload has successfully been uploaded. Progress will be at 1, and the download URL will be populated. \n
- \"failed\" -> The upload has failed. Check the Detail key for information. \n
Authorization
\nRequires an API key using the Authorization Bearer Header.
\n","auth":{"type":"bearer","bearer":{"token":"{{api_key}}"},"isInherited":true,"source":{"_postman_id":"4244cdaf-ece6-4b6d-a2ca-463a3af48f54","id":"4244cdaf-ece6-4b6d-a2ca-463a3af48f54","name":"Main API","type":"collection"}},"urlObject":{"path":["{{api_version}}","api","integration","jobs","{{hash}}"],"host":["{{api_base}}"],"query":[],"variable":[]}},"response":[{"id":"9ff80301-5b97-4956-bedd-138b1d3bac4e","name":"Success","originalRequest":{"method":"GET","header":[],"url":"{{api_base}}/{{api_version}}/api/integration/jobs/{{hash}}"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n\t\"success\": true,\n \"error\": null,\n\t\"detail\": \"Jobs retrieved successfully.\",\n\t\"data\": [\n\t\t{\n\t\t\t\"id\": 0,\n\t\t\t\"created_at\": \"2024-06-13T07:51:12.40135+00:00\",\n\t\t\t\"updated_at\": \"2024-06-13T07:51:22.21287+00:00\",\n\t\t\t\"auth_id\": \"string\",\n\t\t\t\"hash\": \"string\",\n\t\t\t\"type\": \"string\",\n\t\t\t\"integration\": \"string\",\n\t\t\t\"file_id\": 0,\n\t\t\t\"zip\": false,\n\t\t\t\"progress\": 1,\n\t\t\t\"detail\": \"string\",\n\t\t\t\"download_url\": \"https://xxxx\",\n\t\t\t\"status\": \"string\",\n \"file_name\": \"string\",\n \"task_id\": \"string\"\n\t\t}\n\t]\n}"},{"id":"5954cdfc-2668-4dc6-b166-7654013f7556","name":"Fail UNKNOWN_ERROR","originalRequest":{"method":"GET","header":[],"url":"{{api_base}}/{{api_version}}/api/integration/jobs/{{hash}}"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"UNKNOWN_ERROR\",\n \"detail\": \"There was an error getting the jobs.\",\n \"data\": null\n}"},{"id":"fcaffa67-e431-4899-bf49-9124d8791cb8","name":"Fail AUTH_ERROR","originalRequest":{"method":"GET","header":[],"url":"{{api_base}}/{{api_version}}/api/integration/jobs/{{hash}}"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"AUTH_ERROR\",\n \"detail\": \"There was an error verifying your API key. Please try again later.\",\n \"data\": null\n}"},{"id":"cca2401e-ea5c-40cc-b76d-4d1375b52eb8","name":"Fail NO_AUTH","originalRequest":{"method":"GET","header":[],"url":"{{api_base}}/{{api_version}}/api/integration/jobs/{{hash}}"},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"detail\": \"Please provide a valid API token.\",\n \"error\": \"NO_AUTH\",\n \"data\": null\n}"},{"id":"acf12267-e295-4429-9f80-4836696ed81b","name":"Fail BAD_TOKEN","originalRequest":{"method":"GET","header":[],"url":"{{api_base}}/{{api_version}}/api/integration/jobs/{{hash}}"},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"BAD_TOKEN\",\n \"detail\": \"Your token is invalid or has expired. Please log in again or reset your token.\",\n \"data\": null\n}"}],"_postman_id":"9c3f2993-efcc-46a2-8d39-da5e774f8b5b"},{"name":"Cancel Specific Job","id":"50d0f0fa-f189-4883-9068-42a6937b59c6","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[],"url":"{{api_base}}/{{api_version}}/api/integration/job/{{job_id}}","description":"Overview
\nCancels a job or deletes the job. Cancels while in progess (pending, uploading), or deletes the job any other time. It will delete it from the database completely.
\nAuthorization
\nRequires an API key using the Authorization Bearer Header.
\n","auth":{"type":"bearer","bearer":{"token":"{{api_key}}"},"isInherited":true,"source":{"_postman_id":"4244cdaf-ece6-4b6d-a2ca-463a3af48f54","id":"4244cdaf-ece6-4b6d-a2ca-463a3af48f54","name":"Main API","type":"collection"}},"urlObject":{"path":["{{api_version}}","api","integration","job","{{job_id}}"],"host":["{{api_base}}"],"query":[],"variable":[]}},"response":[{"id":"0af89bd0-34d6-43d6-9b7f-ac8383eb6d1f","name":"Success","originalRequest":{"method":"DELETE","header":[],"url":"{{api_base}}/{{api_version}}/api/integration/job/{{job_id}}"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"error\": null,\n \"detail\": \"Job successfully cancelled.\",\n \"data\": null\n}"},{"id":"c0cafff1-b2c6-4d09-988e-d72d6d4f3639","name":"Fail ITEM_NOT_FOUND","originalRequest":{"method":"DELETE","header":[],"url":"{{api_base}}/{{api_version}}/api/integration/job/{{job_id}}"},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"ITEM_NOT_FOUND\",\n \"detail\": \"No job found.\",\n \"data\": null\n}"},{"id":"232bb410-5c56-4361-9041-5c6947f12074","name":"Fail UNKNOWN_ERROR","originalRequest":{"method":"DELETE","header":[],"url":"{{api_base}}/{{api_version}}/api/integration/job/{{job_id}}"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"UNKNOWN_ERROR\",\n \"detail\": \"There was an error cancelling the job.\",\n \"data\": null\n}"},{"id":"460df633-7feb-4181-9aac-3a6473df6893","name":"Fail AUTH_ERROR","originalRequest":{"method":"DELETE","header":[],"url":"{{api_base}}/{{api_version}}/api/integration/job/{{job_id}}"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"AUTH_ERROR\",\n \"detail\": \"There was an error verifying your API key. Please try again later.\",\n \"data\": null\n}"},{"id":"fff41687-e576-415c-b49d-02cbd64311c4","name":"Fail NO_AUTH","originalRequest":{"method":"DELETE","header":[],"url":"{{api_base}}/{{api_version}}/api/integration/job/{{job_id}}"},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"detail\": \"Please provide a valid API token.\",\n \"error\": \"NO_AUTH\",\n \"data\": null\n}"},{"id":"77881063-42ff-4941-b61b-bc1ccae17e96","name":"Fail BAD_TOKEN","originalRequest":{"method":"DELETE","header":[],"url":"{{api_base}}/{{api_version}}/api/integration/job/{{job_id}}"},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"BAD_TOKEN\",\n \"detail\": \"Your token is invalid or has expired. Please log in again or reset your token.\",\n \"data\": null\n}"}],"_postman_id":"50d0f0fa-f189-4883-9068-42a6937b59c6"}],"id":"5604ec8e-8a04-4407-85bf-db83dfab33b3","description":"Overview
\nIntegrations is the route for connecting to 3rd party services. This includes OAuth, Jobs, and creating integration connections.
\nAuthorization
\nFor all requests, you will need your API token which can be found on your TorBox settings page under the API key section. Simply copy or refresh the API token and use it in the API.
\nEndpoints /api/integrations
\n- \n
\nGETAuthenticate OAuth/oauth/{provider}\n
\nPOSTQueue Google Drive/googledrive\n
\nPOSTQueue Pixeldrain/pixeldrain\n
\nPOSTQueue OneDrive/onedrive\n
\nPOSTQueue GoFile/gofile\n
\nPOSTQueue 1Fichier/1fichier\n
\nGETGet All Jobs/jobs\n
\nGETGet Specific Job/job/{job_id}\n
\nGETGet All Jobs By Hash/jobs/{hash}\n
Overview
\nRetrieves all of a user's queued downloads by type. If you want to get all 3 types, \"torrent\", \"usenet\" and \"webdl\" then you will need to run this request 3 times, each with the different type.
\nAuthorization
\nRequires an API key using the Authorization Bearer Header.
\n","auth":{"type":"bearer","bearer":{"token":"{{api_key}}"},"isInherited":true,"source":{"_postman_id":"4244cdaf-ece6-4b6d-a2ca-463a3af48f54","id":"4244cdaf-ece6-4b6d-a2ca-463a3af48f54","name":"Main API","type":"collection"}},"urlObject":{"path":["{{api_version}}","api","queued","getqueued"],"host":["{{api_base}}"],"query":[{"description":{"content":"Allows you to bypass the cached data, and always get fresh information. Useful if constantly querying for fresh download stats. Otherwise, we request that you save our database a few calls.
\n","type":"text/plain"},"key":"bypass_cache","value":""},{"description":{"content":"Determines the queued download requested, will return an object rather than list. Optional.
\n","type":"text/plain"},"key":"id","value":""},{"description":{"content":"Determines the offset of items to get from the database. Default is 0. Optional.
\n","type":"text/plain"},"key":"offset","value":""},{"description":{"content":"Determines the number of items to recieve per request. Default is 1000. Optional.
\n","type":"text/plain"},"key":"limit","value":""},{"description":{"content":"The type of the queued download you want to retrieve. Can be \"torrent\", \"usenet\" or \"webdl\". Optional. Default is \"torrent\".
\n","type":"text/plain"},"key":"type","value":"torrent"}],"variable":[]}},"response":[{"id":"8dad1486-59a1-42a6-9f8d-45555d31152c","name":"Success","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{api_base}}/{{api_version}}/api/queued/getqueued?bypass_cache=&id=&offset=&limit=&type=torrent","host":["{{api_base}}"],"path":["{{api_version}}","api","queued","getqueued"],"query":[{"key":"bypass_cache","value":"","description":"Allows you to bypass the cached data, and always get fresh information. Useful if constantly querying for fresh download stats. Otherwise, we request that you save our database a few calls."},{"key":"id","value":"","description":"Determines the queued download requested, will return an object rather than list. Optional."},{"key":"offset","value":"","description":"Determines the offset of items to get from the database. Default is 0. Optional."},{"key":"limit","value":"","description":"Determines the number of items to recieve per request. Default is 1000. Optional."},{"key":"type","value":"torrent","description":"The type of the queued download you want to retrieve. Can be \"torrent\", \"usenet\" or \"webdl\". Optional. Default is \"torrent\"."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n\t\"success\": true,\n\t\"error\": null,\n\t\"detail\": \"Queued downloads list retrieved successfully.\",\n\t\"data\": [\n\t\t{\n\t\t\t\"id\": 0,\n\t\t\t\"created_at\": \"2026-03-10T00:10:13Z\",\n\t\t\t\"magnet\": \"string\",\n\t\t\t\"torrent_file\": \"string\",\n\t\t\t\"hash\": \"string\",\n\t\t\t\"name\": \"string\",\n\t\t\t\"type\": \"torrent\",\n\t\t\t\"name_override\": \"string\",\n\t\t\t\"seed_torrent_override\": 3\n\t\t}\n ]\n}"},{"id":"b7b7d2c7-65bb-42b6-9a8a-6433032bc78b","name":"Fail DATABASE_ERROR","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{api_base}}/{{api_version}}/api/queued/getqueued?bypass_cache=&id=&offset=&limit=&type=torrent","host":["{{api_base}}"],"path":["{{api_version}}","api","queued","getqueued"],"query":[{"key":"bypass_cache","value":"","description":"Allows you to bypass the cached data, and always get fresh information. Useful if constantly querying for fresh download stats. Otherwise, we request that you save our database a few calls."},{"key":"id","value":"","description":"Determines the queued download requested, will return an object rather than list. Optional."},{"key":"offset","value":"","description":"Determines the offset of items to get from the database. Default is 0. Optional."},{"key":"limit","value":"","description":"Determines the number of items to recieve per request. Default is 1000. Optional."},{"key":"type","value":"torrent","description":"The type of the queued download you want to retrieve. Can be \"torrent\", \"usenet\" or \"webdl\". Optional. Default is \"torrent\"."}]}},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"DATABASE_ERROR\",\n \"detail\": \"There was an error processing your request. Please try again later.\",\n \"data\": null\n}"},{"id":"cf457be4-cacf-4f20-8828-e1886145a51d","name":"Fail ITEM_NOT_FOUND","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{api_base}}/{{api_version}}/api/queued/getqueued?bypass_cache=&id=&offset=&limit=&type=torrent","host":["{{api_base}}"],"path":["{{api_version}}","api","queued","getqueued"],"query":[{"key":"bypass_cache","value":"","description":"Allows you to bypass the cached data, and always get fresh information. Useful if constantly querying for fresh download stats. Otherwise, we request that you save our database a few calls."},{"key":"id","value":"","description":"Determines the queued download requested, will return an object rather than list. Optional."},{"key":"offset","value":"","description":"Determines the offset of items to get from the database. Default is 0. Optional."},{"key":"limit","value":"","description":"Determines the number of items to recieve per request. Default is 1000. Optional."},{"key":"type","value":"torrent","description":"The type of the queued download you want to retrieve. Can be \"torrent\", \"usenet\" or \"webdl\". Optional. Default is \"torrent\"."}]}},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"error\": \"ITEM_NOT_FOUND\",\n \"detail\": \"No queued downloads found for this user of this type.\", \n \"data\": []\n}"},{"id":"c544541c-4fcf-4ad8-a00f-39594f16f40d","name":"Fail UNKNOWN_ERROR","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{api_base}}/{{api_version}}/api/queued/getqueued?bypass_cache=&id=&offset=&limit=&type=torrent","host":["{{api_base}}"],"path":["{{api_version}}","api","queued","getqueued"],"query":[{"key":"bypass_cache","value":"","description":"Allows you to bypass the cached data, and always get fresh information. Useful if constantly querying for fresh download stats. Otherwise, we request that you save our database a few calls."},{"key":"id","value":"","description":"Determines the queued download requested, will return an object rather than list. Optional."},{"key":"offset","value":"","description":"Determines the offset of items to get from the database. Default is 0. Optional."},{"key":"limit","value":"","description":"Determines the number of items to recieve per request. Default is 1000. Optional."},{"key":"type","value":"torrent","description":"The type of the queued download you want to retrieve. Can be \"torrent\", \"usenet\" or \"webdl\". Optional. Default is \"torrent\"."}]}},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"UNKNOWN_ERROR\",\n \"detail\": \"There was an error processing your request. Please try again later.\",\n \"data\": null\n}"},{"id":"f12e00ba-c62e-4732-88ba-5175889bd85b","name":"Fail AUTH_ERROR","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{api_base}}/{{api_version}}/api/queued/getqueued?bypass_cache=&id=&offset=&limit=&type=torrent","host":["{{api_base}}"],"path":["{{api_version}}","api","queued","getqueued"],"query":[{"key":"bypass_cache","value":"","description":"Allows you to bypass the cached data, and always get fresh information. Useful if constantly querying for fresh download stats. Otherwise, we request that you save our database a few calls."},{"key":"id","value":"","description":"Determines the queued download requested, will return an object rather than list. Optional."},{"key":"offset","value":"","description":"Determines the offset of items to get from the database. Default is 0. Optional."},{"key":"limit","value":"","description":"Determines the number of items to recieve per request. Default is 1000. Optional."},{"key":"type","value":"torrent","description":"The type of the queued download you want to retrieve. Can be \"torrent\", \"usenet\" or \"webdl\". Optional. Default is \"torrent\"."}]}},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"AUTH_ERROR\",\n \"detail\": \"There was an error verifying your API key. Please try again later.\",\n \"data\": null\n}"},{"id":"800fbd04-4b34-40a3-854d-9c39978ad868","name":"Fail NO_AUTH","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{api_base}}/{{api_version}}/api/queued/getqueued?bypass_cache=&id=&offset=&limit=&type=torrent","host":["{{api_base}}"],"path":["{{api_version}}","api","queued","getqueued"],"query":[{"key":"bypass_cache","value":"","description":"Allows you to bypass the cached data, and always get fresh information. Useful if constantly querying for fresh download stats. Otherwise, we request that you save our database a few calls."},{"key":"id","value":"","description":"Determines the queued download requested, will return an object rather than list. Optional."},{"key":"offset","value":"","description":"Determines the offset of items to get from the database. Default is 0. Optional."},{"key":"limit","value":"","description":"Determines the number of items to recieve per request. Default is 1000. Optional."},{"key":"type","value":"torrent","description":"The type of the queued download you want to retrieve. Can be \"torrent\", \"usenet\" or \"webdl\". Optional. Default is \"torrent\"."}]}},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"detail\": \"Please provide a valid API token.\",\n \"error\": \"NO_AUTH\",\n \"data\": null\n}"},{"id":"c848e503-50ed-4587-aaf8-ac97bc3c5723","name":"Fail BAD_TOKEN","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{api_base}}/{{api_version}}/api/queued/getqueued?bypass_cache=&id=&offset=&limit=&type=torrent","host":["{{api_base}}"],"path":["{{api_version}}","api","queued","getqueued"],"query":[{"key":"bypass_cache","value":"","description":"Allows you to bypass the cached data, and always get fresh information. Useful if constantly querying for fresh download stats. Otherwise, we request that you save our database a few calls."},{"key":"id","value":"","description":"Determines the queued download requested, will return an object rather than list. Optional."},{"key":"offset","value":"","description":"Determines the offset of items to get from the database. Default is 0. Optional."},{"key":"limit","value":"","description":"Determines the number of items to recieve per request. Default is 1000. Optional."},{"key":"type","value":"torrent","description":"The type of the queued download you want to retrieve. Can be \"torrent\", \"usenet\" or \"webdl\". Optional. Default is \"torrent\"."}]}},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"BAD_TOKEN\",\n \"detail\": \"Your token is invalid or has expired. Please log in again or reset your token.\",\n \"data\": null\n}"}],"_postman_id":"097e3b5d-c34d-449a-b26b-603ed3e6f6fe"},{"name":"Control Queued Downloads","id":"2e9b7b90-5544-478d-8744-e04543f4f0b8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n\t\"queued_id\": 0, // the queued torrent's id, optional if using the \"all\" parameter\n\t\"operation\": \"string\", // the operation you want to perform on the torrent\n\t\"all\": false // if you want to do this operation to all queued torrents in your account, optional if using the \"queued_id\" parameter\n}","options":{"raw":{"language":"json"}}},"url":"{{api_base}}/{{api_version}}/api/queued/controlqueued","description":"Overview
\nControls a queued torrent. By sending the queued torrent's ID and the type of operation you want to perform, it will perform that action on the queued torrent.
\nOperations are either:
\n- \n
Delete
\ndeletes the queued download from your account\nStart
\nstarts a queued download, cannot be used with the \"all\" parameter\n
Authorization
\nRequires an API key using the Authorization Bearer Header.
\n","auth":{"type":"bearer","bearer":{"token":"{{api_key}}"},"isInherited":true,"source":{"_postman_id":"4244cdaf-ece6-4b6d-a2ca-463a3af48f54","id":"4244cdaf-ece6-4b6d-a2ca-463a3af48f54","name":"Main API","type":"collection"}},"urlObject":{"path":["{{api_version}}","api","queued","controlqueued"],"host":["{{api_base}}"],"query":[],"variable":[]}},"response":[{"id":"26d8af19-77ef-49ed-a980-cdbdaf69467c","name":"Success","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n\t\"queued_id\": 0, // the queued torrent's id, optional if using the \"all\" parameter\n\t\"operation\": \"string\", // the operation you want to perform on the torrent\n\t\"all\": false // if you want to do this operation to all queued torrents in your account, optional if using the \"queued_id\" parameter\n}","options":{"raw":{"language":"json"}}},"url":"{{api_base}}/{{api_version}}/api/queued/controlqueued"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"error\": null,\n \"detail\": \"Queued download {data.operation}d successfully.\",\n \"data\": null\n}"},{"id":"1ba1d494-93da-409b-b516-aeb05cb447c9","name":"Fail DATABASE_ERROR","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n\t\"queued_id\": 0, // the queued torrent's id, optional if using the \"all\" parameter\n\t\"operation\": \"string\", // the operation you want to perform on the torrent\n\t\"all\": false // if you want to do this operation to all queued torrents in your account, optional if using the \"queued_id\" parameter\n}","options":{"raw":{"language":"json"}}},"url":"{{api_base}}/{{api_version}}/api/queued/controlqueued"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"DATABASE_ERROR\",\n \"detail\": \"Some error will go here regarding your request.\",\n \"data\": null\n}"},{"id":"fb16ca0a-1aa7-46c6-9f99-f63f6d840055","name":"Fail UNKNOWN_ERROR","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n\t\"queued_id\": 0, // the queued torrent's id, optional if using the \"all\" parameter\n\t\"operation\": \"string\", // the operation you want to perform on the torrent\n\t\"all\": false // if you want to do this operation to all queued torrents in your account, optional if using the \"queued_id\" parameter\n}","options":{"raw":{"language":"json"}}},"url":"{{api_base}}/{{api_version}}/api/queued/controlqueued"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"UNKNOWN_ERROR\",\n \"detail\": \"There was an error processing your request. Please try again later.\",\n \"data\": null\n}"},{"id":"f24a6c64-82df-4d15-8844-49325cacb4cf","name":"Fail INVALID_OPTION","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n\t\"queued_id\": 0, // the queued torrent's id, optional if using the \"all\" parameter\n\t\"operation\": \"string\", // the operation you want to perform on the torrent\n\t\"all\": false // if you want to do this operation to all queued torrents in your account, optional if using the \"queued_id\" parameter\n}","options":{"raw":{"language":"json"}}},"url":"{{api_base}}/{{api_version}}/api/queued/controlqueued"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"INVALID_OPTION\",\n \"detail\": \"Invalid operation. Please use one of the following: 'delete', 'start'.\",\n \"data\": null\n}"},{"id":"fe04007f-4e51-4c41-b473-75395aa691a6","name":"Fail AUTH_ERROR","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n\t\"queued_id\": 0, // the queued torrent's id, optional if using the \"all\" parameter\n\t\"operation\": \"string\", // the operation you want to perform on the torrent\n\t\"all\": false // if you want to do this operation to all queued torrents in your account, optional if using the \"queued_id\" parameter\n}","options":{"raw":{"language":"json"}}},"url":"{{api_base}}/{{api_version}}/api/queued/controlqueued"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"AUTH_ERROR\",\n \"detail\": \"There was an error verifying your API key. Please try again later.\",\n \"data\": null\n}"},{"id":"78eb6d14-4714-4b6b-8948-7804a74a888f","name":"Fail NO_AUTH","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n\t\"queued_id\": 0, // the queued torrent's id, optional if using the \"all\" parameter\n\t\"operation\": \"string\", // the operation you want to perform on the torrent\n\t\"all\": false // if you want to do this operation to all queued torrents in your account, optional if using the \"queued_id\" parameter\n}","options":{"raw":{"language":"json"}}},"url":"{{api_base}}/{{api_version}}/api/queued/controlqueued"},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"detail\": \"Please provide a valid API token.\",\n \"error\": \"NO_AUTH\",\n \"data\": null\n}"},{"id":"00698874-e424-43db-9455-7f1880dd75a5","name":"Fail BAD_TOKEN","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n\t\"queued_id\": 0, // the queued torrent's id, optional if using the \"all\" parameter\n\t\"operation\": \"string\", // the operation you want to perform on the torrent\n\t\"all\": false // if you want to do this operation to all queued torrents in your account, optional if using the \"queued_id\" parameter\n}","options":{"raw":{"language":"json"}}},"url":"{{api_base}}/{{api_version}}/api/queued/controlqueued"},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"BAD_TOKEN\",\n \"detail\": \"Your token is invalid or has expired. Please log in again or reset your token.\",\n \"data\": null\n}"}],"_postman_id":"2e9b7b90-5544-478d-8744-e04543f4f0b8"}],"id":"9822ca28-d124-4ebb-b09f-cd1098e5f38a","description":"Overview
\nTorBox's queued service is like no other, and is a feature that no one else in this space has. TorBox is proud to allow the use of the queue system over the API, and these are the docs for how to do so!
\nAdding Queued
\nYou might notice there are no routes to add a queued download. That's because there isn't anything necessarily dedicated to doing so. Instead on the /creatorrent, /createusenetdownload, and /createwebdownload routes, you can send the \"as_queued\" form data set to \"true\" and the download will be created as a queued download. This way you don't have to mess up your flow and can simply add a boolean flag when necessary.
\nAuthorization
\nFor all requests, you will need your API token which can be found on your TorBox settings page under the API key section. Simply copy or refresh the API token and use it in the API.
\nEndpoints /api/queued
\n- \n
\nGETGet Queued Downloads/getqueued\n
\nPOSTControl Queued Downloads/controlqueued\n
Overview
\nCreates a new stream based off of the data provided.
\nSelecting Subtitles and Audios
\nWe use indexes to determine which audio and subtitle you would like to select. To view all available indexes, you must request this endpoint intially with \"null\" or 0, for the chosen indexes. This will return a metadata dictionary in the response, which will contain the list of audios and subtitles available for this stream. When choosing a subtitle or audio stream, use the relative index, starting from 0, rather than the \"index\" value. This is important for selecting the correct index. Once your user gets a selection of audios and subtitles available, you can submit this to the endpoint again to get the chosen stream.
\n- \n
null - Selecting no subtitle. Not available for audio as one must always be selected.
\n \n0 - Selecting first subtitle or audio
\n \n
Selecting Resolution
\nSimilar to the subtitles and audios, we use indexes to determine the resolution chosen. Unlike the above, these are predetermined. We do not upscale video, so if for example, you pass a 1080p video, and request it with resolution, 7, it will stay at 1080p. Please see the below for options.
\n- \n
null - Original video resolution. No downscaling will take place.
\n \n0 - 144p
\n \n1 - 240p
\n \n2 - 360p
\n \n3 - 480p
\n \n4 - 720p
\n \n5 - 1080p
\n \n6 - 1440p
\n \n7 - 2160p
\n \n
Types
\nThis endpoint allows you to handle torrents, usenet and web downloads all in one. This is why the \"type\" parameter is available. It defaults to \"torrent\".
\n- \n
torrent - Torrents
\n \nusenet - Usenet downloads
\n \nwebdownload - Web Downloads
\n \n
Important Notes
\n- \n
Only text based subtitles are supported. If a non-text based subtitle is selected, it will be ignored.
\n \nIf a subtitle or audio index does not exist on the stream, it will be ignored.
\n \nThere are a lot of edge-case videos, if something doesn't work, don't hesitate to report the download hash and file_id of the failing video file.
\n \nThis is a Pro only feature.
\n \n
Authorization
\nRequires an API key using the Authorization Bearer Header.
\n","auth":{"type":"bearer","bearer":{"token":"{{api_key}}"},"isInherited":true,"source":{"_postman_id":"4244cdaf-ece6-4b6d-a2ca-463a3af48f54","id":"4244cdaf-ece6-4b6d-a2ca-463a3af48f54","name":"Main API","type":"collection"}},"urlObject":{"path":["{{api_version}}","api","stream","createstream"],"host":["{{api_base}}"],"query":[{"description":{"content":"The ID of the type of download.
\n","type":"text/plain"},"key":"id","value":""},{"description":{"content":"The file ID inside of the download you would like to stream.
\n","type":"text/plain"},"key":"file_id","value":"0"},{"description":{"content":"The type of download that this is. If choosing the incorrect one, the ID will be incorrect.
\n","type":"text/plain"},"key":"type","value":"torrent"},{"description":{"content":"The relative index of the subtitle you would like to stream. This is default null for none. 0 is the first subtitle found.
\n","type":"text/plain"},"key":"chosen_subtitle_index","value":""},{"description":{"content":"The relative index of the subtitle you would like to stream. Defaults to 0 for the first audio stream found inside the file. Cannot be null.
\n","type":"text/plain"},"key":"chosen_audio_index","value":"0"},{"description":{"content":"The index of the resolution you would like to stream. This is default null for original.
\n","type":"text/plain"},"key":"chosen_resolution_index","value":null}],"variable":[]}},"response":[{"id":"71f56adf-ca48-45f2-b73e-6f93217e1ecf","name":"Success","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{api_base}}/{{api_version}}/api/stream/createstream?id=&file_id=0&type=torrent&chosen_subtitle_index=&chosen_audio_index=0&chosen_resolution_index","host":["{{api_base}}"],"path":["{{api_version}}","api","stream","createstream"],"query":[{"key":"id","value":"","description":"The ID of the type of download."},{"key":"file_id","value":"0","description":"The file ID inside of the download you would like to stream."},{"key":"type","value":"torrent","description":"The type of download that this is. If choosing the incorrect one, the ID will be incorrect."},{"key":"chosen_subtitle_index","value":"","description":"The relative index of the subtitle you would like to stream. This is default null for none. 0 is the first subtitle found."},{"key":"chosen_audio_index","value":"0","description":"The relative index of the subtitle you would like to stream. Defaults to 0 for the first audio stream found inside the file. Cannot be null."},{"key":"chosen_resolution_index","value":null,"description":"The index of the resolution you would like to stream. This is default null for original."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n\t\"success\": true,\n\t\"error\": null,\n\t\"detail\": \"Stream initialized successfully.\",\n\t\"data\": {\n\t\t\"id\": 0,\n\t\t\"file_id\": 0,\n\t\t\"auth_id\": \"string\",\n\t\t\"name\": \"string\",\n\t\t\"short_name\": \"string\",\n\t\t\"s3_path\": \"string\",\n\t\t\"size\": 0,\n\t\t\"mimetype\": \"string\",\n\t\t\"hash\": \"string\",\n\t\t\"open_subtitles_hash\": \"string\",\n\t\t\"type\": \"torrent\",\n\t\t\"region\": \"wnam\",\n\t\t\"domain\": \"https://xxxx\",\n\t\t\"user_token\": \"string\",\n\t\t\"webdav_url\": \"https://xxxx\",\n\t\t\"intro_information\": {\n\t\t\t\"start_time\": 0,\n\t\t\t\"end_time\": 0,\n\t\t\t\"title\": \"string\"\n\t\t},\n\t\t\"scrobbling_enabled\": true,\n\t\t\"hls_url\": \"https://xxxx\",\n\t\t\"presigned_token\": \"string\",\n\t\t\"subtitle_index\": 0,\n\t\t\"audio_index\": 0,\n\t\t\"resolution_index\": 0,\n\t\t\"is_transcoding\": false,\n\t\t\"needs_transcoding\": true,\n\t\t\"metadata\": {\n\t\t\t\"video\": {\n\t\t\t\t\"index\": 0,\n\t\t\t\t\"codec_type\": \"video\",\n\t\t\t\t\"codec\": \"string\",\n\t\t\t\t\"width\": 0,\n\t\t\t\t\"height\": 0,\n\t\t\t\t\"frame_rate\": \"0\",\n\t\t\t\t\"pixel_format\": \"string\",\n\t\t\t\t\"bitrate\": \"string\",\n\t\t\t\t\"duration\": \"string\",\n\t\t\t\t\"total_chunks\": 0,\n\t\t\t\t\"file_name\": \"string\",\n\t\t\t\t\"opensubtitles_hash\": \"string\",\n\t\t\t\t\"size\": 0,\n\t\t\t\t\"title\": \"string\",\n\t\t\t\t\"title_data\": {}\n\t\t\t},\n\t\t\t\"audios\": [\n\t\t\t\t{\n\t\t\t\t\t\"index\": 1,\n\t\t\t\t\t\"codec_type\": \"audio\",\n\t\t\t\t\t\"codec\": \"string\",\n\t\t\t\t\t\"default\": true,\n\t\t\t\t\t\"sample_rate\": \"string\",\n\t\t\t\t\t\"channels\": 0,\n\t\t\t\t\t\"channel_layout\": \"string\",\n\t\t\t\t\t\"language\": \"string\",\n\t\t\t\t\t\"language_full\": \"string\",\n\t\t\t\t\t\"title\": \"string\"\n\t\t\t\t}\n\t\t\t],\n\t\t\t\"subtitles\": [],\n\t\t\t\"thumbnail\": \"thumbnail.png\",\n\t\t\t\"chapters\": \"chapters.vtt\"\n\t\t},\n\t\t\"search_metadata\": {\n\t\t\t\"title\": \"string\",\n\t\t\t\"titles\": [\n\t\t\t\t\"string\",\n \"string\"\n\t\t\t],\n\t\t\t\"keywords\": [\n\t\t\t\t\"string\",\n \"string\"\n\t\t\t],\n\t\t\t\"genres\": [\n\t\t\t\t\"string\",\n \"string\"\n\t\t\t],\n\t\t\t\"actors\": [\n \"string\",\n \"string\"\n ],\n\t\t\t\"releaseYears\": \"20XX-20XX\",\n\t\t\t\"mediaType\": \"string\",\n\t\t\t\"characters\": [\n \"string\",\n \"string\"\n ],\n\t\t\t\"globalID\": \"string\",\n\t\t\t\"id\": \"string\",\n\t\t\t\"link\": \"https://xxxx\",\n\t\t\t\"description\": \"string\",\n\t\t\t\"rating\": 0,\n\t\t\t\"languages\": [\n \"string\",\n \"string\"\n ],\n\t\t\t\"contentRating\": \"string\",\n\t\t\t\"trailer\": {},\n\t\t\t\"image\": \"https://xxxx\",\n\t\t\t\"isAdult\": false,\n\t\t\t\"type\": \"string\",\n\t\t\t\"releasedDate\": \"2000-01-27T00:00:00.000Z\",\n\t\t\t\"episodesNumber\": 0,\n\t\t\t\"runtime\": \"string\",\n\t\t\t\"titles_full\": [\n\t\t\t\t{\n\t\t\t\t\t\"language\": \"string\",\n\t\t\t\t\t\"title\": \"string\"\n\t\t\t\t}\n\t\t\t],\n\t\t\t\"backdrop\": \"https://xxxx\"\n\t\t}\n\t}\n}"},{"id":"dd7d2a93-3ff4-4976-9c53-977213a507a6","name":"Fail INVALID_OPTION","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{api_base}}/{{api_version}}/api/stream/createstream?id=&file_id=0&type=torrent&chosen_subtitle_index=&chosen_audio_index=0&chosen_resolution_index","host":["{{api_base}}"],"path":["{{api_version}}","api","stream","createstream"],"query":[{"key":"id","value":"","description":"The ID of the type of download."},{"key":"file_id","value":"0","description":"The file ID inside of the download you would like to stream."},{"key":"type","value":"torrent","description":"The type of download that this is. If choosing the incorrect one, the ID will be incorrect."},{"key":"chosen_subtitle_index","value":"","description":"The relative index of the subtitle you would like to stream. This is default null for none. 0 is the first subtitle found."},{"key":"chosen_audio_index","value":"0","description":"The relative index of the subtitle you would like to stream. Defaults to 0 for the first audio stream found inside the file. Cannot be null."},{"key":"chosen_resolution_index","value":null,"description":"The index of the resolution you would like to stream. This is default null for original."}]}},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"INVALID_OPTION\",\n \"detail\": \"Invalid type. Please use either 'torrent', 'usenet', or 'webdownload'.\",\n \"data\": null\n}"},{"id":"160f0dd9-8899-48b3-8d1c-c7a31e6279bb","name":"Fail ITEM_NOT_FOUND","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{api_base}}/{{api_version}}/api/stream/createstream?id=&file_id=0&type=torrent&chosen_subtitle_index=&chosen_audio_index=0&chosen_resolution_index","host":["{{api_base}}"],"path":["{{api_version}}","api","stream","createstream"],"query":[{"key":"id","value":"","description":"The ID of the type of download."},{"key":"file_id","value":"0","description":"The file ID inside of the download you would like to stream."},{"key":"type","value":"torrent","description":"The type of download that this is. If choosing the incorrect one, the ID will be incorrect."},{"key":"chosen_subtitle_index","value":"","description":"The relative index of the subtitle you would like to stream. This is default null for none. 0 is the first subtitle found."},{"key":"chosen_audio_index","value":"0","description":"The relative index of the subtitle you would like to stream. Defaults to 0 for the first audio stream found inside the file. Cannot be null."},{"key":"chosen_resolution_index","value":null,"description":"The index of the resolution you would like to stream. This is default null for original."}]}},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"ITEM_NOT_FOUND\",\n \"detail\": \"Item not found. Please try again with a different ID.\",\n \"data\": null\n}"},{"id":"c478827a-aaf5-4507-81c1-94ff40c293ff","name":"Fail PLAN_RESTRICTED_FEATURE","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{api_base}}/{{api_version}}/api/stream/createstream?id=&file_id=0&type=torrent&chosen_subtitle_index=&chosen_audio_index=0&chosen_resolution_index","host":["{{api_base}}"],"path":["{{api_version}}","api","stream","createstream"],"query":[{"key":"id","value":"","description":"The ID of the type of download."},{"key":"file_id","value":"0","description":"The file ID inside of the download you would like to stream."},{"key":"type","value":"torrent","description":"The type of download that this is. If choosing the incorrect one, the ID will be incorrect."},{"key":"chosen_subtitle_index","value":"","description":"The relative index of the subtitle you would like to stream. This is default null for none. 0 is the first subtitle found."},{"key":"chosen_audio_index","value":"0","description":"The relative index of the subtitle you would like to stream. Defaults to 0 for the first audio stream found inside the file. Cannot be null."},{"key":"chosen_resolution_index","value":null,"description":"The index of the resolution you would like to stream. This is default null for original."}]}},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"PLAN_RESTRICTED_FEATURE\",\n \"detail\": \"User is not allowed to use web streaming. Please upgrade your plan for access to this feature.\",\n \"data\": null\n}"},{"id":"9bc0b32e-c5bf-4d4f-abe8-a0bc67dce105","name":"Fail BOZO_FILE","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{api_base}}/{{api_version}}/api/stream/createstream?id=&file_id=0&type=torrent&chosen_subtitle_index=&chosen_audio_index=0&chosen_resolution_index","host":["{{api_base}}"],"path":["{{api_version}}","api","stream","createstream"],"query":[{"key":"id","value":"","description":"The ID of the type of download."},{"key":"file_id","value":"0","description":"The file ID inside of the download you would like to stream."},{"key":"type","value":"torrent","description":"The type of download that this is. If choosing the incorrect one, the ID will be incorrect."},{"key":"chosen_subtitle_index","value":"","description":"The relative index of the subtitle you would like to stream. This is default null for none. 0 is the first subtitle found."},{"key":"chosen_audio_index","value":"0","description":"The relative index of the subtitle you would like to stream. Defaults to 0 for the first audio stream found inside the file. Cannot be null."},{"key":"chosen_resolution_index","value":null,"description":"The index of the resolution you would like to stream. This is default null for original."}]}},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"BOZO_FILE\",\n \"detail\": \"File is not a video file. Please try again with a different file.\",\n \"data\": null\n}"},{"id":"b1dfdd17-d42b-4405-8a54-12d449aa9b8e","name":"Fail LINK_OFFLINE","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{api_base}}/{{api_version}}/api/stream/createstream?id=&file_id=0&type=torrent&chosen_subtitle_index=&chosen_audio_index=0&chosen_resolution_index","host":["{{api_base}}"],"path":["{{api_version}}","api","stream","createstream"],"query":[{"key":"id","value":"","description":"The ID of the type of download."},{"key":"file_id","value":"0","description":"The file ID inside of the download you would like to stream."},{"key":"type","value":"torrent","description":"The type of download that this is. If choosing the incorrect one, the ID will be incorrect."},{"key":"chosen_subtitle_index","value":"","description":"The relative index of the subtitle you would like to stream. This is default null for none. 0 is the first subtitle found."},{"key":"chosen_audio_index","value":"0","description":"The relative index of the subtitle you would like to stream. Defaults to 0 for the first audio stream found inside the file. Cannot be null."},{"key":"chosen_resolution_index","value":null,"description":"The index of the resolution you would like to stream. This is default null for original."}]}},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"LINK_OFFLINE\",\n \"detail\": \"This file is offline. Please try again later.\",\n \"data\": null\n}"},{"id":"60e4f3ca-6c47-429d-8871-df0e6fea871a","name":"Fail STREAM_INFO_ERROR","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{api_base}}/{{api_version}}/api/stream/createstream?id=&file_id=0&type=torrent&chosen_subtitle_index=&chosen_audio_index=0&chosen_resolution_index","host":["{{api_base}}"],"path":["{{api_version}}","api","stream","createstream"],"query":[{"key":"id","value":"","description":"The ID of the type of download."},{"key":"file_id","value":"0","description":"The file ID inside of the download you would like to stream."},{"key":"type","value":"torrent","description":"The type of download that this is. If choosing the incorrect one, the ID will be incorrect."},{"key":"chosen_subtitle_index","value":"","description":"The relative index of the subtitle you would like to stream. This is default null for none. 0 is the first subtitle found."},{"key":"chosen_audio_index","value":"0","description":"The relative index of the subtitle you would like to stream. Defaults to 0 for the first audio stream found inside the file. Cannot be null."},{"key":"chosen_resolution_index","value":null,"description":"The index of the resolution you would like to stream. This is default null for original."}]}},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"STREAM_INFO_ERROR\",\n \"detail\": \"There was an error getting the stream info. Please try again later.\",\n \"data\": null\n}"},{"id":"e9ee664a-c179-44ce-95a6-46fa586a845d","name":"Fail UNKNOWN_ERROR","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{api_base}}/{{api_version}}/api/stream/createstream?id=&file_id=0&type=torrent&chosen_subtitle_index=&chosen_audio_index=0&chosen_resolution_index","host":["{{api_base}}"],"path":["{{api_version}}","api","stream","createstream"],"query":[{"key":"id","value":"","description":"The ID of the type of download."},{"key":"file_id","value":"0","description":"The file ID inside of the download you would like to stream."},{"key":"type","value":"torrent","description":"The type of download that this is. If choosing the incorrect one, the ID will be incorrect."},{"key":"chosen_subtitle_index","value":"","description":"The relative index of the subtitle you would like to stream. This is default null for none. 0 is the first subtitle found."},{"key":"chosen_audio_index","value":"0","description":"The relative index of the subtitle you would like to stream. Defaults to 0 for the first audio stream found inside the file. Cannot be null."},{"key":"chosen_resolution_index","value":null,"description":"The index of the resolution you would like to stream. This is default null for original."}]}},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"UNKNOWN_ERROR\",\n \"detail\": \"There was an error creating the stream. Please try again later.\",\n \"data\": null\n}"},{"id":"788ce8f6-ef00-4837-8343-37ac66163567","name":"Fail AUTH_ERROR","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{api_base}}/{{api_version}}/api/stream/createstream?id=&file_id=0&type=torrent&chosen_subtitle_index=&chosen_audio_index=0&chosen_resolution_index","host":["{{api_base}}"],"path":["{{api_version}}","api","stream","createstream"],"query":[{"key":"id","value":"","description":"The ID of the type of download."},{"key":"file_id","value":"0","description":"The file ID inside of the download you would like to stream."},{"key":"type","value":"torrent","description":"The type of download that this is. If choosing the incorrect one, the ID will be incorrect."},{"key":"chosen_subtitle_index","value":"","description":"The relative index of the subtitle you would like to stream. This is default null for none. 0 is the first subtitle found."},{"key":"chosen_audio_index","value":"0","description":"The relative index of the subtitle you would like to stream. Defaults to 0 for the first audio stream found inside the file. Cannot be null."},{"key":"chosen_resolution_index","value":null,"description":"The index of the resolution you would like to stream. This is default null for original."}]}},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"AUTH_ERROR\",\n \"detail\": \"There was an error verifying your API key. Please try again later.\",\n \"data\": null\n}"},{"id":"f454acd7-835d-472c-8361-a5391068efc9","name":"Fail NO_AUTH","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{api_base}}/{{api_version}}/api/stream/createstream?id=&file_id=0&type=torrent&chosen_subtitle_index=&chosen_audio_index=0&chosen_resolution_index","host":["{{api_base}}"],"path":["{{api_version}}","api","stream","createstream"],"query":[{"key":"id","value":"","description":"The ID of the type of download."},{"key":"file_id","value":"0","description":"The file ID inside of the download you would like to stream."},{"key":"type","value":"torrent","description":"The type of download that this is. If choosing the incorrect one, the ID will be incorrect."},{"key":"chosen_subtitle_index","value":"","description":"The relative index of the subtitle you would like to stream. This is default null for none. 0 is the first subtitle found."},{"key":"chosen_audio_index","value":"0","description":"The relative index of the subtitle you would like to stream. Defaults to 0 for the first audio stream found inside the file. Cannot be null."},{"key":"chosen_resolution_index","value":null,"description":"The index of the resolution you would like to stream. This is default null for original."}]}},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"detail\": \"Please provide a valid API token.\",\n \"error\": \"NO_AUTH\",\n \"data\": null\n}"},{"id":"b077621e-e7bb-4cd5-9914-12ebef51bf59","name":"Fail BAD_TOKEN","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{api_base}}/{{api_version}}/api/stream/createstream?id=&file_id=0&type=torrent&chosen_subtitle_index=&chosen_audio_index=0&chosen_resolution_index","host":["{{api_base}}"],"path":["{{api_version}}","api","stream","createstream"],"query":[{"key":"id","value":"","description":"The ID of the type of download."},{"key":"file_id","value":"0","description":"The file ID inside of the download you would like to stream."},{"key":"type","value":"torrent","description":"The type of download that this is. If choosing the incorrect one, the ID will be incorrect."},{"key":"chosen_subtitle_index","value":"","description":"The relative index of the subtitle you would like to stream. This is default null for none. 0 is the first subtitle found."},{"key":"chosen_audio_index","value":"0","description":"The relative index of the subtitle you would like to stream. Defaults to 0 for the first audio stream found inside the file. Cannot be null."},{"key":"chosen_resolution_index","value":null,"description":"The index of the resolution you would like to stream. This is default null for original."}]}},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"BAD_TOKEN\",\n \"detail\": \"Your token is invalid or has expired. Please log in again or reset your token.\",\n \"data\": null\n}"}],"_postman_id":"52c32a7a-54da-4acc-bf70-2bed0b6c6dd2"},{"name":"Get Stream Data","id":"1ead2b26-6ec0-4834-9136-1b087d066bad","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"token":"{{api_key}}"},"isInherited":false},"method":"GET","header":[],"url":"{{api_base}}/{{api_version}}/api/stream/getstreamdata?presigned_token&token&chosen_subtitle_index&chosen_audio_index&chosen_resolution_index","description":"Overview
\nGets stream data from an already created stream. Requires the presigned token and user API token from the original request.
\nAuthorization
\nRequires an API key using the Authorization Bearer Header.
\n","urlObject":{"path":["{{api_version}}","api","stream","getstreamdata"],"host":["{{api_base}}"],"query":[{"description":{"content":"The presigned token given from the original, /createstream request.
\n","type":"text/plain"},"key":"presigned_token","value":null},{"description":{"content":"The user's API token, can also be used from the original, /createstream request.
\n","type":"text/plain"},"key":"token","value":null},{"description":{"content":"The chosen subtitle index that you are requesting information about.
\n","type":"text/plain"},"key":"chosen_subtitle_index","value":null},{"description":{"content":"The chosen audio index that you are requesting information about.
\n","type":"text/plain"},"key":"chosen_audio_index","value":null},{"description":{"content":"The index of the resolution you would like to stream. This is default null for original.
\n","type":"text/plain"},"key":"chosen_resolution_index","value":null}],"variable":[]}},"response":[{"id":"782bed8f-bd25-4143-b3f7-e848c79f7da0","name":"Success","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{api_base}}/{{api_version}}/api/stream/getstreamdata?presigned_token&token&chosen_subtitle_index&chosen_audio_index&chosen_resolution_index","host":["{{api_base}}"],"path":["{{api_version}}","api","stream","getstreamdata"],"query":[{"key":"presigned_token","value":null,"description":"The presigned token given from the original, /createstream request."},{"key":"token","value":null,"description":"The user's API token, can also be used from the original, /createstream request."},{"key":"chosen_subtitle_index","value":null,"description":"The chosen subtitle index that you are requesting information about."},{"key":"chosen_audio_index","value":null,"description":"The chosen audio index that you are requesting information about."},{"key":"chosen_resolution_index","value":null,"description":"The index of the resolution you would like to stream. This is default null for original."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"error\": null,\n \"detail\": \"Stream initialized successfully.\",\n \"data\": {\n \"hls_url\": \"https://xxxx\",\n \"domain\": \"https://xxxx\",\n \"presigned_token\": \"string\",\n \"subtitle_index\": 0,\n \"audio_index\": 0,\n \"resolution_index\": 0,\n \"file_token\": \"string\",\n \"token\": \"string\",\n \"is_transcoding\": false,\n \"needs_transcoding\": true,\n \"metadata\": {\n \"video\": {\n \"index\": 0,\n \"codec_type\": \"video\",\n \"codec\": \"string\",\n \"width\": 0,\n \"height\": 0,\n \"frame_rate\": \"0\",\n \"pixel_format\": \"string\",\n \"bitrate\": \"string\",\n \"duration\": \"string\",\n \"total_chunks\": 0,\n \"file_name\": \"string\",\n \"opensubtitles_hash\": \"string\",\n \"size\": 0,\n \"title\": \"string\",\n \"title_data\": {}\n },\n \"audios\": [\n {\n \"index\": 1,\n \"codec_type\": \"audio\",\n \"codec\": \"string\",\n \"default\": true,\n \"sample_rate\": \"string\",\n \"channels\": 0,\n \"channel_layout\": \"string\",\n \"language\": \"string\",\n \"language_full\": \"string\",\n \"title\": \"string\"\n }\n ],\n \"subtitles\": [],\n \"thumbnail\": \"thumbnail.png\",\n \"chapters\": \"chapters.vtt\"\n },\n \"search_metadata\": {\n \"title\": \"string\",\n \"titles\": [\n \"string\",\n \"string\"\n ],\n \"keywords\": [\n \"string\",\n \"string\"\n ],\n \"genres\": [\n \"string\",\n \"string\"\n ],\n \"actors\": [\n \"string\",\n \"string\"\n ],\n \"releaseYears\": \"20XX-20XX\",\n \"mediaType\": \"string\",\n \"characters\": [\n \"string\",\n \"string\"\n ],\n \"globalID\": \"string\",\n \"id\": \"string\",\n \"link\": \"https://xxxx\",\n \"description\": \"string\",\n \"rating\": 0,\n \"languages\": [\n \"string\",\n \"string\"\n ],\n \"contentRating\": \"string\",\n \"trailer\": {},\n \"image\": \"https://xxxx\",\n \"isAdult\": false,\n \"type\": \"string\",\n \"releasedDate\": \"2000-01-27T00:00:00.000Z\",\n \"episodesNumber\": 0,\n \"runtime\": \"string\",\n \"titles_full\": [\n {\n \"language\": \"string\",\n \"title\": \"string\"\n }\n ],\n \"backdrop\": \"https://xxxx\"\n }\n }\n}"},{"id":"dbd0cbd5-69ac-41d2-a8d6-f3362972834f","name":"Fail ITEM_NOT_FOUND","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{api_base}}/{{api_version}}/api/stream/getstreamdata?presigned_token&token&chosen_subtitle_index&chosen_audio_index&chosen_resolution_index","host":["{{api_base}}"],"path":["{{api_version}}","api","stream","getstreamdata"],"query":[{"key":"presigned_token","value":null,"description":"The presigned token given from the original, /createstream request."},{"key":"token","value":null,"description":"The user's API token, can also be used from the original, /createstream request."},{"key":"chosen_subtitle_index","value":null,"description":"The chosen subtitle index that you are requesting information about."},{"key":"chosen_audio_index","value":null,"description":"The chosen audio index that you are requesting information about."},{"key":"chosen_resolution_index","value":null,"description":"The index of the resolution you would like to stream. This is default null for original."}]}},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"ITEM_NOT_FOUND\",\n \"detail\": \"Invalid presigned token. Please get a new streaming link.\",\n \"data\": null\n}"},{"id":"6f4abca3-d159-40be-bcf9-cb5a597632bd","name":"Fail UNKNOWN_ERROR","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{api_base}}/{{api_version}}/api/stream/getstreamdata?presigned_token&token&chosen_subtitle_index&chosen_audio_index&chosen_resolution_index","host":["{{api_base}}"],"path":["{{api_version}}","api","stream","getstreamdata"],"query":[{"key":"presigned_token","value":null,"description":"The presigned token given from the original, /createstream request."},{"key":"token","value":null,"description":"The user's API token, can also be used from the original, /createstream request."},{"key":"chosen_subtitle_index","value":null,"description":"The chosen subtitle index that you are requesting information about."},{"key":"chosen_audio_index","value":null,"description":"The chosen audio index that you are requesting information about."},{"key":"chosen_resolution_index","value":null,"description":"The index of the resolution you would like to stream. This is default null for original."}]}},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"UNKNOWN_ERROR\",\n \"detail\": \"There was an error getting the stream data. Please try again later.\",\n \"data\": null\n }"},{"id":"e98a2159-cf08-4d9a-b23f-5df8af10935b","name":"Fail AUTH_ERROR","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{api_base}}/{{api_version}}/api/stream/getstreamdata?presigned_token&token&chosen_subtitle_index&chosen_audio_index&chosen_resolution_index","host":["{{api_base}}"],"path":["{{api_version}}","api","stream","getstreamdata"],"query":[{"key":"presigned_token","value":null,"description":"The presigned token given from the original, /createstream request."},{"key":"token","value":null,"description":"The user's API token, can also be used from the original, /createstream request."},{"key":"chosen_subtitle_index","value":null,"description":"The chosen subtitle index that you are requesting information about."},{"key":"chosen_audio_index","value":null,"description":"The chosen audio index that you are requesting information about."},{"key":"chosen_resolution_index","value":null,"description":"The index of the resolution you would like to stream. This is default null for original."}]}},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"AUTH_ERROR\",\n \"detail\": \"There was an error verifying your API key. Please try again later.\",\n \"data\": null\n}"},{"id":"cdd5a945-5c98-489e-9030-805d94539972","name":"Fail NO_AUTH","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{api_base}}/{{api_version}}/api/stream/getstreamdata?presigned_token&token&chosen_subtitle_index&chosen_audio_index&chosen_resolution_index","host":["{{api_base}}"],"path":["{{api_version}}","api","stream","getstreamdata"],"query":[{"key":"presigned_token","value":null,"description":"The presigned token given from the original, /createstream request."},{"key":"token","value":null,"description":"The user's API token, can also be used from the original, /createstream request."},{"key":"chosen_subtitle_index","value":null,"description":"The chosen subtitle index that you are requesting information about."},{"key":"chosen_audio_index","value":null,"description":"The chosen audio index that you are requesting information about."},{"key":"chosen_resolution_index","value":null,"description":"The index of the resolution you would like to stream. This is default null for original."}]}},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"detail\": \"Please provide a valid API token.\",\n \"error\": \"NO_AUTH\",\n \"data\": null\n}"},{"id":"47018ea1-c422-408f-b6ca-f8bc46eaaeaf","name":"Fail BAD_TOKEN","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{api_base}}/{{api_version}}/api/stream/getstreamdata?presigned_token&token&chosen_subtitle_index&chosen_audio_index&chosen_resolution_index","host":["{{api_base}}"],"path":["{{api_version}}","api","stream","getstreamdata"],"query":[{"key":"presigned_token","value":null,"description":"The presigned token given from the original, /createstream request."},{"key":"token","value":null,"description":"The user's API token, can also be used from the original, /createstream request."},{"key":"chosen_subtitle_index","value":null,"description":"The chosen subtitle index that you are requesting information about."},{"key":"chosen_audio_index","value":null,"description":"The chosen audio index that you are requesting information about."},{"key":"chosen_resolution_index","value":null,"description":"The index of the resolution you would like to stream. This is default null for original."}]}},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"error\": \"BAD_TOKEN\",\n \"detail\": \"Your token is invalid or has expired. Please log in again or reset your token.\",\n \"data\": null\n}"}],"_postman_id":"1ead2b26-6ec0-4834-9136-1b087d066bad"}],"id":"21d65505-e650-44d0-84a1-b491d8fa8bf9","description":"Overview
\nWith the release of TorBox v8.1 we are introducing the ability to stream any video file directly in your browser, and this is fully powered by our API, which is available for developers to integrate into their apps. With minimal wait times for stream starts, low bandwidth streaming, and integrated subtitles and audio choosing, this API makes it simple to create a web player based off of a user's TorBox video files.
\nAuthorization
\nFor all requests, you will need your API token which can be found on your TorBox settings page under the API key section. Simply copy or refresh the API token and use it in the API.
\nEndpoints /api/stream
\n- \n
\nGETCreate Stream/createstream\n
\nGETGet Stream Data/getstreamdata\n