Delete a price watch

Stop watching.

DELETEhttps://api.tcggraph.com/v1/watches/{id}No credits · metering

Path parameters

Parameter	Type	Description
idrequired	string	The watch's id.

Response

200 Confirmation.

Field	Type	Description
data	object	What was deleted.
data.id	string	The watch's id.
data.deleted	boolean	Always `true`.

Examples

Real responses from the production API, recorded on 2026-09-24 by the script that also checks every field above against them. Arrays are shown in full.

Delete it

curl -X DELETE "https://api.tcggraph.com/v1/watches/c245e388-33da-446a-89b1-b6afc908cf05" \
  -H "Authorization: Bearer $TCGGRAPH_API_KEY"

const response = await fetch("https://api.tcggraph.com/v1/watches/c245e388-33da-446a-89b1-b6afc908cf05", {
  method: "DELETE",
  headers: {
    Authorization: `Bearer ${process.env.TCGGRAPH_API_KEY}`,
  },
});
const body = await response.json();
if (!response.ok) throw new Error(`${body.error.code}: ${body.error.message}`);

import os
import requests

response = requests.delete(
    "https://api.tcggraph.com/v1/watches/c245e388-33da-446a-89b1-b6afc908cf05",
    headers={"Authorization": f"Bearer {os.environ['TCGGRAPH_API_KEY']}"},
)
body = response.json()
response.raise_for_status()

200 · X-Credits-Cost: 0

{
  "data": {
    "id": "c245e388-33da-446a-89b1-b6afc908cf05",
    "deleted": true
  }
}

Errors

Every error has the same body; switch on error.code. Any endpoint can also answer 401, 402, 403 or 429 for reasons of key, plan or rate; those are on Errors.

Status	Code	When
404	not_found	No watch with that id on this account.

Already deleted

curl -X DELETE "https://api.tcggraph.com/v1/watches/c245e388-33da-446a-89b1-b6afc908cf05" \
  -H "Authorization: Bearer $TCGGRAPH_API_KEY"

const response = await fetch("https://api.tcggraph.com/v1/watches/c245e388-33da-446a-89b1-b6afc908cf05", {
  method: "DELETE",
  headers: {
    Authorization: `Bearer ${process.env.TCGGRAPH_API_KEY}`,
  },
});
const body = await response.json();
if (!response.ok) throw new Error(`${body.error.code}: ${body.error.message}`);

import os
import requests

response = requests.delete(
    "https://api.tcggraph.com/v1/watches/c245e388-33da-446a-89b1-b6afc908cf05",
    headers={"Authorization": f"Bearer {os.environ['TCGGRAPH_API_KEY']}"},
)
body = response.json()
response.raise_for_status()

404

{
  "error": {
    "code": "not_found",
    "message": "No price watch with id \"c245e388-33da-446a-89b1-b6afc908cf05\"."
  }
}