Delete a Creator Watchlist API

Deletes one of your watchlists including its memberships, and frees the watchlist slot and followed-profile slots it used. Free to call. Works for lists created through the API or in the web app; only the owner can delete a list.

Remove a watchlist and everything in it in one free call. The watchlist slot and every followed-profile slot it used are released back to your allowance, so cleaning up temporary lists is how an agent keeps room for new ones.

How to call it

DELETE /api/v1/watchlists. Authenticate with your API key. Same call in three languages:

curl -X DELETE "https://viraloutliers.com/api/v1/watchlists" \
  -H "Authorization: Bearer so_live_YOUR_KEY"

import requests

r = requests.delete(
"https://viraloutliers.com/api/v1/watchlists",
    headers={"Authorization": "Bearer so_live_YOUR_KEY"},
)
print(r.json())

const res = await fetch("https://viraloutliers.com/api/v1/watchlists", {
  method: "DELETE",
  headers: { "Authorization": "Bearer so_live_YOUR_KEY" },
});
const data = await res.json();
console.log(data);

Parameters

Pricing

This skill is free and never spends credits.

Agent workflows

• Cleanup: list_watchlists → delete_watchlist for temporary api lists a workflow no longer needs.

Frequently asked questions