Decypharr provides a RESTful API for managing torrents, debrid services, and Arr integrations. The API requires authentication and all endpoints are prefixed with /api.
The API supports two authentication methods:
+Log in through the web interface (/login) to establish an authenticated session. The session cookie (auth-session) will be automatically included in subsequent API requests from the same browser session.
Use API tokens for programmatic access. Include the token in the Authorization header for each request:
Authorization: Bearer <your-token>GET /api/arrs - Get all configured Arr applications (Sonarr, Radarr, etc.)POST /api/add - Add torrent files or magnet links for processing through debrid servicesPOST /api/repair - Start repair process for media itemsGET /api/repair/jobs - Get all repair jobsPOST /api/repair/jobs/{id}/process - Process a specific repair jobPOST /api/repair/jobs/{id}/stop - Stop a running repair jobDELETE /api/repair/jobs - Delete multiple repair jobsGET /api/torrents - Get all torrentsDELETE /api/torrents/{category}/{hash} - Delete a specific torrentDELETE /api/torrents/ - Delete multiple torrentscurl -H "Authorization: Bearer $API_TOKEN" -X POST http://localhost:8080/api/add \
+ -F "arr=sonarr" \
+ -F "debrid=realdebrid" \
+ -F "urls=magnet:?xt=urn:btih:..." \
+ -F "downloadUncached=true"
+ -F "file=@/path/to/torrent/file.torrent"
+ -F "callbackUrl=http://your.callback.url/endpoint"
+# Login first (this sets the session cookie)
+curl -c cookies.txt -X POST http://localhost:8080/login \
+ -H "Content-Type: application/json" \
+ -d '{"username": "your_username", "password": "your_password"}'
+
+# Then use the session cookie for API calls
+curl -b cookies.txt -X POST http://localhost:8080/api/add \
+ -F "arr=sonarr" \
+ -F "debrid=realdebrid" \
+ -F "urls=magnet:?xt=urn:btih:..." \
+ -F "downloadUncached=true"
+# With API token
+curl -H "Authorization: Bearer $API_TOKEN" -X GET http://localhost:8080/api/torrents
+# With API token
+curl -H "Authorization: Bearer $API_TOKEN" -X POST http://localhost:8080/api/repair \
+ -H "Content-Type: application/json" \
+ -d '{
+ "arrName": "sonarr",
+ "mediaIds": ["123", "456"],
+ "autoProcess": true,
+ "async": true
+ }'
+