Delete a Watchlist

This endpoint deletes the specified watchlist.
Note: You cannot delete the user's default watchlist.

HTTP Request


Query Parameters

Parameter Description Type Required
api_version Must be v3. String Yes (URL)
account_token Used by the Watchlist Service to reference the watchlist associated with a particular end user (identified by their UUID). For details, see Ooyala Account Token API. String Yes (URL)
watchlist_id The ID of the watchlist to delete. This must be a valid UID and it must exist in the user's account. You cannot delete a user's default watchlist. UUIDv4 OR String Yes (URL)

Return Codes

Code Reason Description
200 OK DELETE request succeeded. Watchlist deleted successfully.
400 Request error Failed due to any of the following issues:
  • Parameters are missing or formatted incorrectly.
  • The specified watchlist_id is the default watchlist for this user.
  • The specified watchlist name is "default" (or any case variation of the word).
  • The watchlist with the specified name does not exist for this user.
401 Unauthorized The specified account_token is invalid.
404 Not found The server is down.
500 Internal server error An internal server error occurred.


Response (Success)