Stop an Activity
A Plex server can have multiple activities running at different times. Activities such as scanning media, database maintenance or streaming can happen either on-demand or on a schedule.
While many of these activities shouldn't cause issues when they are running, if you do notice the performance of the server decreasing, you can stop any of the running activities using this API command.
URL
DELETE http://{ip_address}:32400/activites/{id}?X-Plex-Token={plex_token}Parameters
| Name | Description |
|---|---|
| ip_address | The IP address of the Plex Media server. |
| plex_token | The Plex token. |
| id | The UUID associated with a running activity. This key can be found by calling the Get All Activities API command. |
Return Status
| HTTP Code | Description |
|---|---|
| 200 | Success - The activity was canceled. |
| 401 | Unauthorized - The Plex token provided was not valid. |
| 404 | Not Found - The activity for the provided UUID was not running. |
Response
No response is returned by the command. The status code will indicate whether the activity was stopped successfully.
Examples
curl -X DELETE http://{ip_address}:32400/activites/{id}?X-Plex-Token={plex_token}
import requests
plex_url = http://{ip_address}:32400/activites/{id}?X-Plex-Token={plex_token}
response = requests.delete(plex_url)
print(response.text)
$response = Invoke-RestMethod 'http://{ip_address}:32400/activites/{id}?X-Plex-Token={plex_token}' -Method DELETE
Write-Output $response