Skip to main content
POST
/
v1
/
watches
/
{id}
/
replay
curl -X POST "https://api.signa.so/v1/watches/wat_01HK7M.../replay" \
  -H "Authorization: Bearer $SIGNA_API_KEY" \
  -H "Idempotency-Key: replay-wat-01HK7M-2026-06-12"

​
Overview

Bumps the watch’s evaluation_epoch, which causes the evaluator to re-process every watched office on the next sync. Use this after a query edit or to verify behaviour following backfilled data corrections. Required scope: watches:admin.
watches:admin is not self-service — replay can produce a flood of alerts, so the scope is granted only to admin/automation keys on request. Email support@signa.so to have it enabled.

​
Path Parameters

​
id
string
required
Watch ID (wat_*).

​
Body Parameters

None. Send an empty body.
from_date is not supported in v1 — sending it (as a query param or in the body) returns 400. Historical replay-from-date is reserved for v1.1; today /replay re-evaluates from the next ingestion sync forward only.

​
Response

Returns the updated Watch with the new evaluation_epoch.

​
Errors

  • 400 — from_date supplied (reserved for v1.1).
  • 403 — caller lacks watches:admin scope.
  • 404 — watch does not exist.
  • 409 — an evaluator is currently holding the per-(watch, office) lease. Retry once the 15-minute stale-takeover window elapses, or wait for the in-flight run to complete.
curl -X POST "https://api.signa.so/v1/watches/wat_01HK7M.../replay" \
  -H "Authorization: Bearer $SIGNA_API_KEY" \
  -H "Idempotency-Key: replay-wat-01HK7M-2026-06-12"