Skip to main content
PATCH
Update a board watch

Authorizations

Authorization
string
header
required

API key issued from the developer dashboard. Pass as Authorization: Bearer vq_key_...

Path Parameters

watch_id
string
required

Body

application/json
isActive
boolean | null

Pause (false) or resume (true) the watch.

webhookUrl
string | null

New webhook URL. Only valid on a webhook/both channel watch. Re-validated against the SSRF blocklist. Cannot be cleared.

webhookSecret
string | null

New signing secret, or empty string to stop signing deliveries. Only valid on a webhook/both channel watch.

scope
Scope · object | null

Optional narrowing so this alert covers one citation instead of an entire source. Three mutually exclusive forms.

Hierarchy prefix -- keys title, chapter, part, section, e.g. {"title": "21", "part": "314"} for 21 CFR part 314. Every level you set must match, so each one narrows further. title is required whenever any narrower level is set, and section also needs chapter or part: a bare part number matches across unrelated titles. Only sources whose documents carry a title/chapter/part hierarchy accept this form; the rest return 400.

Exact section -- {"actId": "CFR_T21_P314_S314_50"}, using the actId returned by search results and change events. Case-sensitive, and validated at create time against the corpus: an act_id we do not hold, or one belonging to a different source, is a 400 rather than a watch that could never fire. This form works on EVERY source, including flat ones with no hierarchy, so it is the only way to follow a single Federal Register document.

Omit entirely to watch the whole source, which is the default and the pre-existing behavior.

Named source -- {"source": "fdic_fil"}, for the corpora that fold several independent bodies of law behind one corpusType. agency_guidance alone carries 30 named sources across 16 agencies, so an unscoped watch on it delivers FDIC letters, IRS notices, USPTO examining procedure and DOE appliance standards together. The vocabulary is exactly the source filter published on POST /us/statutes/search. Accepted on agency_guidance, agency_manuals and cfr (where it selects FAR or DFARS, which share every hierarchy field and are distinguishable only by source); anything else returns 400.

Example:
emailAddress
string | null

New email address. Only valid on an email/both channel watch. Cannot be cleared.

webhookAuth
WebhookAuthRequest · object | null

Replace the outbound credential config. Sent as a whole object, not field by field: a scheme without a credential is not a partial edit, it is a broken config. Send {"scheme": "none"} to remove auth entirely. Keeping the same scheme and omitting secret retains the stored credential, so you can rename a header without re-entering the token.

Response

The updated watch.

Last modified on August 23, 2026