Skip to main content
DELETE
/
v1
/
watches
/
{id}
Delete Watch
curl --request DELETE \
  --url https://api.example.com/v1/watches/{id}
{
  "id": "wat_abc123",
  "object": "watch",
  "deleted": true,
  "livemode": true,
  "request_id": "req_xyz"
}

​
Overview

Soft-deletes a watch by setting its deleted_at timestamp. Existing alerts on the watch are preserved for audit. The watch stops generating new alerts. Requires the portfolios:manage scope.

​
Path Parameters

​
id
string
required
Watch ID (wat_...).

​
Response

​
id
string
Echo of the deleted watch ID.
​
object
string
Always watch.
​
deleted
boolean
Always true on success.
{
  "id": "wat_abc123",
  "object": "watch",
  "deleted": true,
  "livemode": true,
  "request_id": "req_xyz"
}

​
Code Examples

curl -X DELETE "https://api.signa.so/v1/watches/wat_abc123" \
  -H "Authorization: Bearer sig_live_YOUR_KEY_HERE"

​
Errors

StatusTypeDescription
400validation_errorInvalid watch ID format
401unauthorizedMissing or invalid API key
403forbiddenAPI key lacks portfolios:manage
404not_foundWatch does not exist or belongs to another org