{"catalog_version":1,"app":"programmable.watch","docs":"https://programmable.watch/docs/api","auth":{"header":"Authorization: Bearer wsk_…","key_prefix":"wsk_","scopes":{"read":"Reads only.","full":"Reads and writes; acts as the account's owner."}},"webhooks":{"envelope":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Identifies the event: the same value at every endpoint that receives it"},"event":{"type":"string","enum":["findings.changed","supplier.status_changed","supplier.blocked","supplier.unblocked","supplier.approved","supplier.rejected","case.opened","case.updated","case.closed","award.created","export.ready","audit.anchor","test"]},"type":{"type":"string","enum":["findings.changed","supplier.status_changed","supplier.blocked","supplier.unblocked","supplier.approved","supplier.rejected","case.opened","case.updated","case.closed","award.created","export.ready","audit.anchor","test"],"description":"The same value as event, under the name the other Programmable apps use"},"created_at":{"type":"string","format":"date-time"},"data":{"type":"object"}},"required":["id","event","type","created_at","data"]},"headers":{"X-Programmable-Signature":"t=<unix seconds>,v1=<hex HMAC-SHA256 of \"<t>.<raw body>\" with the endpoint's signing secret (whsec_…)>. For 24 hours after a secret is rotated there is a second v1, for the secret before it; accept if any v1 matches","X-Programmable-Id":"Identifies the delivery to this endpoint; the same on every retry, so a receiver can drop duplicates"},"signing_secret_prefix":"whsec_","rotation_overlap_hours":24,"retries":"A 2xx answer within 15 seconds is a delivery. Anything else is retried with growing gaps for about a day (8 tries), then marked failed; a failed delivery can be sent again from Developers > Webhooks or the API.","subscribe":[{"what":"The account's own webhook, one per account","methods":["GET","PUT","DELETE"],"path":"/api/account/webhook","body":"{url, enabled?, rotateSecret?, watchlist_ids?}"},{"what":"Further endpoints, up to 5 per account, each with its own secret","methods":["GET","POST"],"path":"/api/account/webhooks","body":"{name, url, enabled?, watchlist_ids?, events?}"},{"what":"Change or remove a further endpoint","methods":["PATCH","DELETE"],"path":"/api/account/webhooks/{id}","body":"{name?, url?, enabled?, watchlist_ids?, events?, rotateSecret?}"}],"needs":"A full-access key or the account's owner."},"events":[{"name":"findings.changed","scope":"list","summary":"Findings opened or resolved on one supplier after a check.","data":{"type":"object","properties":{"watchlist_id":{"type":"string","format":"uuid"},"row_id":{"type":"string","format":"uuid"},"supplier":{"type":"string"},"uei":{"type":["string","null"]},"uei_only":{"type":"boolean","description":"Present and true when the supplier has a UEI but no SAM.gov registration to read"},"source_version":{"type":["string","null"],"description":"The registry data version the check read"},"opened":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"The finding's number, as a string"},"kind":{"type":"string","description":"What was found, for example registration_expiring"},"severity":{"type":"string","enum":["critical","warning","info"]},"title":{"type":"string"},"detail":{"type":["string","null"]},"data":{"type":["object","null"],"description":"The facts behind the finding; its fields depend on the kind"},"opened_at":{"type":"string"},"resolved_at":{"type":["string","null"]},"resolved_reason":{"type":"string","description":"Present once resolved, when a reason was recorded"}},"required":["id","kind","severity","title","opened_at"]}},"resolved":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"The finding's number, as a string"},"kind":{"type":"string","description":"What was found, for example registration_expiring"},"severity":{"type":"string","enum":["critical","warning","info"]},"title":{"type":"string"},"detail":{"type":["string","null"]},"data":{"type":["object","null"],"description":"The facts behind the finding; its fields depend on the kind"},"opened_at":{"type":"string"},"resolved_at":{"type":["string","null"]},"resolved_reason":{"type":"string","description":"Present once resolved, when a reason was recorded"}},"required":["id","kind","severity","title","opened_at"]}},"also_on":{"type":"array","items":{"type":"object","properties":{"watchlist_id":{"type":"string","format":"uuid"},"name":{"type":"string"},"row_id":{"type":"string","format":"uuid"}},"required":["watchlist_id","name","row_id"]},"description":"Other lists on the account that carry the same registration"}},"required":["watchlist_id","row_id","supplier","opened","resolved"]},"type":"findings.changed","description":"Findings opened or resolved on one supplier after a check.","data_schema":{"type":"object","properties":{"watchlist_id":{"type":"string","format":"uuid"},"row_id":{"type":"string","format":"uuid"},"supplier":{"type":"string"},"uei":{"type":["string","null"]},"uei_only":{"type":"boolean","description":"Present and true when the supplier has a UEI but no SAM.gov registration to read"},"source_version":{"type":["string","null"],"description":"The registry data version the check read"},"opened":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"The finding's number, as a string"},"kind":{"type":"string","description":"What was found, for example registration_expiring"},"severity":{"type":"string","enum":["critical","warning","info"]},"title":{"type":"string"},"detail":{"type":["string","null"]},"data":{"type":["object","null"],"description":"The facts behind the finding; its fields depend on the kind"},"opened_at":{"type":"string"},"resolved_at":{"type":["string","null"]},"resolved_reason":{"type":"string","description":"Present once resolved, when a reason was recorded"}},"required":["id","kind","severity","title","opened_at"]}},"resolved":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"The finding's number, as a string"},"kind":{"type":"string","description":"What was found, for example registration_expiring"},"severity":{"type":"string","enum":["critical","warning","info"]},"title":{"type":"string"},"detail":{"type":["string","null"]},"data":{"type":["object","null"],"description":"The facts behind the finding; its fields depend on the kind"},"opened_at":{"type":"string"},"resolved_at":{"type":["string","null"]},"resolved_reason":{"type":"string","description":"Present once resolved, when a reason was recorded"}},"required":["id","kind","severity","title","opened_at"]}},"also_on":{"type":"array","items":{"type":"object","properties":{"watchlist_id":{"type":"string","format":"uuid"},"name":{"type":"string"},"row_id":{"type":"string","format":"uuid"}},"required":["watchlist_id","name","row_id"]},"description":"Other lists on the account that carry the same registration"}},"required":["watchlist_id","row_id","supplier","opened","resolved"]}},{"name":"supplier.status_changed","scope":"list","summary":"A supplier's status changed. previous_status is null the first time the supplier is seen.","data":{"type":"object","properties":{"row_id":{"type":"string","format":"uuid","description":"The supplier's row on a list"},"vendor_id":{"type":["string","null"],"description":"Your ERP's vendor ID, when the row has one"},"uei":{"type":["string","null"]},"cage":{"type":["string","null"]},"name":{"type":"string"},"watchlist_id":{"type":"string","format":"uuid"},"watchlist":{"type":"string","description":"The list's name"},"status":{"type":"string","description":"The supplier's status in words, as the dashboard shows it"},"match":{"type":"string","description":"How the row is matched to a registration"},"tier":{"type":["string","null"]},"worst_open_severity":{"type":["string","null"]},"open_findings":{"type":"integer"},"blocked":{"type":"boolean","description":"True when an open critical finding (not under an exception) or a case holds the supplier"},"blocked_reasons":{"type":"array","items":{"type":"string"}},"blocked_since":{"type":["string","null"]},"url":{"type":"string","description":"The supplier's page in Watch"},"previous_status":{"type":["string","null"],"description":"Null the first time a supplier is seen"},"previous_blocked":{"type":["boolean","null"]},"seq":{"type":"integer","description":"Increases with every supplier status event on the account; the cursor of /api/zapier/supplier-status"},"changed_at":{"type":"string","format":"date-time"}},"required":["row_id","name","watchlist_id","status","blocked","seq","changed_at"]},"type":"supplier.status_changed","description":"A supplier's status changed. previous_status is null the first time the supplier is seen.","data_schema":{"type":"object","properties":{"row_id":{"type":"string","format":"uuid","description":"The supplier's row on a list"},"vendor_id":{"type":["string","null"],"description":"Your ERP's vendor ID, when the row has one"},"uei":{"type":["string","null"]},"cage":{"type":["string","null"]},"name":{"type":"string"},"watchlist_id":{"type":"string","format":"uuid"},"watchlist":{"type":"string","description":"The list's name"},"status":{"type":"string","description":"The supplier's status in words, as the dashboard shows it"},"match":{"type":"string","description":"How the row is matched to a registration"},"tier":{"type":["string","null"]},"worst_open_severity":{"type":["string","null"]},"open_findings":{"type":"integer"},"blocked":{"type":"boolean","description":"True when an open critical finding (not under an exception) or a case holds the supplier"},"blocked_reasons":{"type":"array","items":{"type":"string"}},"blocked_since":{"type":["string","null"]},"url":{"type":"string","description":"The supplier's page in Watch"},"previous_status":{"type":["string","null"],"description":"Null the first time a supplier is seen"},"previous_blocked":{"type":["boolean","null"]},"seq":{"type":"integer","description":"Increases with every supplier status event on the account; the cursor of /api/zapier/supplier-status"},"changed_at":{"type":"string","format":"date-time"}},"required":["row_id","name","watchlist_id","status","blocked","seq","changed_at"]}},{"name":"supplier.blocked","scope":"list","summary":"A supplier became blocked: an open critical finding not under an exception, or a case put it on hold.","data":{"type":"object","properties":{"row_id":{"type":"string","format":"uuid","description":"The supplier's row on a list"},"vendor_id":{"type":["string","null"],"description":"Your ERP's vendor ID, when the row has one"},"uei":{"type":["string","null"]},"cage":{"type":["string","null"]},"name":{"type":"string"},"watchlist_id":{"type":"string","format":"uuid"},"watchlist":{"type":"string","description":"The list's name"},"status":{"type":"string","description":"The supplier's status in words, as the dashboard shows it"},"match":{"type":"string","description":"How the row is matched to a registration"},"tier":{"type":["string","null"]},"worst_open_severity":{"type":["string","null"]},"open_findings":{"type":"integer"},"blocked":{"type":"boolean","description":"True when an open critical finding (not under an exception) or a case holds the supplier"},"blocked_reasons":{"type":"array","items":{"type":"string"}},"blocked_since":{"type":["string","null"]},"url":{"type":"string","description":"The supplier's page in Watch"},"previous_status":{"type":["string","null"],"description":"Null the first time a supplier is seen"},"previous_blocked":{"type":["boolean","null"]},"seq":{"type":"integer","description":"Increases with every supplier status event on the account; the cursor of /api/zapier/supplier-status"},"changed_at":{"type":"string","format":"date-time"}},"required":["row_id","name","watchlist_id","status","blocked","seq","changed_at"]},"type":"supplier.blocked","description":"A supplier became blocked: an open critical finding not under an exception, or a case put it on hold.","data_schema":{"type":"object","properties":{"row_id":{"type":"string","format":"uuid","description":"The supplier's row on a list"},"vendor_id":{"type":["string","null"],"description":"Your ERP's vendor ID, when the row has one"},"uei":{"type":["string","null"]},"cage":{"type":["string","null"]},"name":{"type":"string"},"watchlist_id":{"type":"string","format":"uuid"},"watchlist":{"type":"string","description":"The list's name"},"status":{"type":"string","description":"The supplier's status in words, as the dashboard shows it"},"match":{"type":"string","description":"How the row is matched to a registration"},"tier":{"type":["string","null"]},"worst_open_severity":{"type":["string","null"]},"open_findings":{"type":"integer"},"blocked":{"type":"boolean","description":"True when an open critical finding (not under an exception) or a case holds the supplier"},"blocked_reasons":{"type":"array","items":{"type":"string"}},"blocked_since":{"type":["string","null"]},"url":{"type":"string","description":"The supplier's page in Watch"},"previous_status":{"type":["string","null"],"description":"Null the first time a supplier is seen"},"previous_blocked":{"type":["boolean","null"]},"seq":{"type":"integer","description":"Increases with every supplier status event on the account; the cursor of /api/zapier/supplier-status"},"changed_at":{"type":"string","format":"date-time"}},"required":["row_id","name","watchlist_id","status","blocked","seq","changed_at"]}},{"name":"supplier.unblocked","scope":"list","summary":"A blocked supplier is no longer blocked.","data":{"type":"object","properties":{"row_id":{"type":"string","format":"uuid","description":"The supplier's row on a list"},"vendor_id":{"type":["string","null"],"description":"Your ERP's vendor ID, when the row has one"},"uei":{"type":["string","null"]},"cage":{"type":["string","null"]},"name":{"type":"string"},"watchlist_id":{"type":"string","format":"uuid"},"watchlist":{"type":"string","description":"The list's name"},"status":{"type":"string","description":"The supplier's status in words, as the dashboard shows it"},"match":{"type":"string","description":"How the row is matched to a registration"},"tier":{"type":["string","null"]},"worst_open_severity":{"type":["string","null"]},"open_findings":{"type":"integer"},"blocked":{"type":"boolean","description":"True when an open critical finding (not under an exception) or a case holds the supplier"},"blocked_reasons":{"type":"array","items":{"type":"string"}},"blocked_since":{"type":["string","null"]},"url":{"type":"string","description":"The supplier's page in Watch"},"previous_status":{"type":["string","null"],"description":"Null the first time a supplier is seen"},"previous_blocked":{"type":["boolean","null"]},"seq":{"type":"integer","description":"Increases with every supplier status event on the account; the cursor of /api/zapier/supplier-status"},"changed_at":{"type":"string","format":"date-time"}},"required":["row_id","name","watchlist_id","status","blocked","seq","changed_at"]},"type":"supplier.unblocked","description":"A blocked supplier is no longer blocked.","data_schema":{"type":"object","properties":{"row_id":{"type":"string","format":"uuid","description":"The supplier's row on a list"},"vendor_id":{"type":["string","null"],"description":"Your ERP's vendor ID, when the row has one"},"uei":{"type":["string","null"]},"cage":{"type":["string","null"]},"name":{"type":"string"},"watchlist_id":{"type":"string","format":"uuid"},"watchlist":{"type":"string","description":"The list's name"},"status":{"type":"string","description":"The supplier's status in words, as the dashboard shows it"},"match":{"type":"string","description":"How the row is matched to a registration"},"tier":{"type":["string","null"]},"worst_open_severity":{"type":["string","null"]},"open_findings":{"type":"integer"},"blocked":{"type":"boolean","description":"True when an open critical finding (not under an exception) or a case holds the supplier"},"blocked_reasons":{"type":"array","items":{"type":"string"}},"blocked_since":{"type":["string","null"]},"url":{"type":"string","description":"The supplier's page in Watch"},"previous_status":{"type":["string","null"],"description":"Null the first time a supplier is seen"},"previous_blocked":{"type":["boolean","null"]},"seq":{"type":"integer","description":"Increases with every supplier status event on the account; the cursor of /api/zapier/supplier-status"},"changed_at":{"type":"string","format":"date-time"}},"required":["row_id","name","watchlist_id","status","blocked","seq","changed_at"]}},{"name":"supplier.approved","scope":"list","summary":"An onboarding was approved.","data":{"type":"object","properties":{"onboarding_id":{"type":["string","integer"]},"row_id":{"type":"string","format":"uuid"},"supplier":{"type":"string"},"uei":{"type":["string","null"]},"cage":{"type":["string","null"]},"watchlist_id":{"type":"string","format":"uuid"},"tier":{"type":["string","null"]},"decisions":{"type":"array","items":{"type":"object"},"description":"Every approver's decision, with who and when"},"conditions":{"type":"array","items":{"type":"object"},"description":"supplier.approved: conditions the approval carries, each with its until date"},"note":{"type":["string","null"],"description":"supplier.rejected: the reason given"}},"required":["onboarding_id","row_id","supplier","watchlist_id","decisions"]},"type":"supplier.approved","description":"An onboarding was approved.","data_schema":{"type":"object","properties":{"onboarding_id":{"type":["string","integer"]},"row_id":{"type":"string","format":"uuid"},"supplier":{"type":"string"},"uei":{"type":["string","null"]},"cage":{"type":["string","null"]},"watchlist_id":{"type":"string","format":"uuid"},"tier":{"type":["string","null"]},"decisions":{"type":"array","items":{"type":"object"},"description":"Every approver's decision, with who and when"},"conditions":{"type":"array","items":{"type":"object"},"description":"supplier.approved: conditions the approval carries, each with its until date"},"note":{"type":["string","null"],"description":"supplier.rejected: the reason given"}},"required":["onboarding_id","row_id","supplier","watchlist_id","decisions"]}},{"name":"supplier.rejected","scope":"list","summary":"An onboarding was rejected.","data":{"type":"object","properties":{"onboarding_id":{"type":["string","integer"]},"row_id":{"type":"string","format":"uuid"},"supplier":{"type":"string"},"uei":{"type":["string","null"]},"cage":{"type":["string","null"]},"watchlist_id":{"type":"string","format":"uuid"},"tier":{"type":["string","null"]},"decisions":{"type":"array","items":{"type":"object"},"description":"Every approver's decision, with who and when"},"conditions":{"type":"array","items":{"type":"object"},"description":"supplier.approved: conditions the approval carries, each with its until date"},"note":{"type":["string","null"],"description":"supplier.rejected: the reason given"}},"required":["onboarding_id","row_id","supplier","watchlist_id","decisions"]},"type":"supplier.rejected","description":"An onboarding was rejected.","data_schema":{"type":"object","properties":{"onboarding_id":{"type":["string","integer"]},"row_id":{"type":"string","format":"uuid"},"supplier":{"type":"string"},"uei":{"type":["string","null"]},"cage":{"type":["string","null"]},"watchlist_id":{"type":"string","format":"uuid"},"tier":{"type":["string","null"]},"decisions":{"type":"array","items":{"type":"object"},"description":"Every approver's decision, with who and when"},"conditions":{"type":"array","items":{"type":"object"},"description":"supplier.approved: conditions the approval carries, each with its until date"},"note":{"type":["string","null"],"description":"supplier.rejected: the reason given"}},"required":["onboarding_id","row_id","supplier","watchlist_id","decisions"]}},{"name":"case.opened","scope":"list","summary":"A case was opened on a supplier.","data":{"type":"object","properties":{"case_id":{"type":["string","integer"],"description":"The case number"},"row_id":{"type":"string","format":"uuid"},"supplier":{"type":["string","null"]},"uei":{"type":["string","null"]},"title":{"type":"string"},"severity":{"type":["string","null"]},"status":{"type":"string"},"disposition":{"type":["string","null"]},"reason":{"type":["string","null"]},"exception_until":{"type":["string","null"]},"due_on":{"type":["string","null"]},"added_findings":{"type":"array","items":{"type":"string"},"description":"case.updated: ids of the findings added to the case"},"proposed":{"type":"string","description":"case.updated: a disposition proposed and waiting for a second person"}},"required":["case_id","row_id","title","status"]},"type":"case.opened","description":"A case was opened on a supplier.","data_schema":{"type":"object","properties":{"case_id":{"type":["string","integer"],"description":"The case number"},"row_id":{"type":"string","format":"uuid"},"supplier":{"type":["string","null"]},"uei":{"type":["string","null"]},"title":{"type":"string"},"severity":{"type":["string","null"]},"status":{"type":"string"},"disposition":{"type":["string","null"]},"reason":{"type":["string","null"]},"exception_until":{"type":["string","null"]},"due_on":{"type":["string","null"]},"added_findings":{"type":"array","items":{"type":"string"},"description":"case.updated: ids of the findings added to the case"},"proposed":{"type":"string","description":"case.updated: a disposition proposed and waiting for a second person"}},"required":["case_id","row_id","title","status"]}},{"name":"case.updated","scope":"list","summary":"A case gained findings, or a disposition was proposed.","data":{"type":"object","properties":{"case_id":{"type":["string","integer"],"description":"The case number"},"row_id":{"type":"string","format":"uuid"},"supplier":{"type":["string","null"]},"uei":{"type":["string","null"]},"title":{"type":"string"},"severity":{"type":["string","null"]},"status":{"type":"string"},"disposition":{"type":["string","null"]},"reason":{"type":["string","null"]},"exception_until":{"type":["string","null"]},"due_on":{"type":["string","null"]},"added_findings":{"type":"array","items":{"type":"string"},"description":"case.updated: ids of the findings added to the case"},"proposed":{"type":"string","description":"case.updated: a disposition proposed and waiting for a second person"}},"required":["case_id","row_id","title","status"]},"type":"case.updated","description":"A case gained findings, or a disposition was proposed.","data_schema":{"type":"object","properties":{"case_id":{"type":["string","integer"],"description":"The case number"},"row_id":{"type":"string","format":"uuid"},"supplier":{"type":["string","null"]},"uei":{"type":["string","null"]},"title":{"type":"string"},"severity":{"type":["string","null"]},"status":{"type":"string"},"disposition":{"type":["string","null"]},"reason":{"type":["string","null"]},"exception_until":{"type":["string","null"]},"due_on":{"type":["string","null"]},"added_findings":{"type":"array","items":{"type":"string"},"description":"case.updated: ids of the findings added to the case"},"proposed":{"type":"string","description":"case.updated: a disposition proposed and waiting for a second person"}},"required":["case_id","row_id","title","status"]}},{"name":"case.closed","scope":"list","summary":"A case was closed with its disposition.","data":{"type":"object","properties":{"case_id":{"type":["string","integer"],"description":"The case number"},"row_id":{"type":"string","format":"uuid"},"supplier":{"type":["string","null"]},"uei":{"type":["string","null"]},"title":{"type":"string"},"severity":{"type":["string","null"]},"status":{"type":"string"},"disposition":{"type":["string","null"]},"reason":{"type":["string","null"]},"exception_until":{"type":["string","null"]},"due_on":{"type":["string","null"]},"added_findings":{"type":"array","items":{"type":"string"},"description":"case.updated: ids of the findings added to the case"},"proposed":{"type":"string","description":"case.updated: a disposition proposed and waiting for a second person"}},"required":["case_id","row_id","title","status"]},"type":"case.closed","description":"A case was closed with its disposition.","data_schema":{"type":"object","properties":{"case_id":{"type":["string","integer"],"description":"The case number"},"row_id":{"type":"string","format":"uuid"},"supplier":{"type":["string","null"]},"uei":{"type":["string","null"]},"title":{"type":"string"},"severity":{"type":["string","null"]},"status":{"type":"string"},"disposition":{"type":["string","null"]},"reason":{"type":["string","null"]},"exception_until":{"type":["string","null"]},"due_on":{"type":["string","null"]},"added_findings":{"type":"array","items":{"type":"string"},"description":"case.updated: ids of the findings added to the case"},"proposed":{"type":"string","description":"case.updated: a disposition proposed and waiting for a second person"}},"required":["case_id","row_id","title","status"]}},{"name":"award.created","scope":"list","summary":"An award was recorded, or its override approved, with the pre-award gate's result.","data":{"type":"object","properties":{"award_id":{"type":"string","format":"uuid"},"vendor_id":{"type":["string","null"]},"number":{"type":["string","null"],"description":"The award or PO number"},"kind":{"type":["string","null"]},"prime_contract":{"type":["string","null"]},"award_date":{"type":["string","null"]},"value":{"type":["number","string","null"]},"row_id":{"type":"string","format":"uuid"},"supplier":{"type":"string"},"uei":{"type":["string","null"]},"gate":{"type":"string","description":"The gate's result for this award"},"blockers":{"type":"array","items":{"type":"string"},"description":"Codes of what blocked or was overridden"},"clause_set":{"type":["string","null"]},"evidence_sha256":{"type":["string","null"],"description":"SHA-256 of the evidence file"},"checked_at":{"type":["string","null"]}},"required":["award_id","row_id","supplier","gate","blockers"]},"type":"award.created","description":"An award was recorded, or its override approved, with the pre-award gate's result.","data_schema":{"type":"object","properties":{"award_id":{"type":"string","format":"uuid"},"vendor_id":{"type":["string","null"]},"number":{"type":["string","null"],"description":"The award or PO number"},"kind":{"type":["string","null"]},"prime_contract":{"type":["string","null"]},"award_date":{"type":["string","null"]},"value":{"type":["number","string","null"]},"row_id":{"type":"string","format":"uuid"},"supplier":{"type":"string"},"uei":{"type":["string","null"]},"gate":{"type":"string","description":"The gate's result for this award"},"blockers":{"type":"array","items":{"type":"string"},"description":"Codes of what blocked or was overridden"},"clause_set":{"type":["string","null"]},"evidence_sha256":{"type":["string","null"],"description":"SHA-256 of the evidence file"},"checked_at":{"type":["string","null"]}},"required":["award_id","row_id","supplier","gate","blockers"]}},{"name":"export.ready","scope":"account","summary":"A scheduled export is ready to download.","data":{"type":"object","properties":{"watchlist_id":{"type":"string","format":"uuid"},"watchlist":{"type":["string","null"]},"snapshot_id":{"type":"string","format":"uuid"},"sha256":{"type":"string","description":"SHA-256 of the export"},"suppliers":{"type":"integer"},"url":{"type":"string","description":"Where to download it"}},"required":["watchlist_id","snapshot_id","sha256","url"]},"type":"export.ready","description":"A scheduled export is ready to download.","data_schema":{"type":"object","properties":{"watchlist_id":{"type":"string","format":"uuid"},"watchlist":{"type":["string","null"]},"snapshot_id":{"type":"string","format":"uuid"},"sha256":{"type":"string","description":"SHA-256 of the export"},"suppliers":{"type":"integer"},"url":{"type":"string","description":"Where to download it"}},"required":["watchlist_id","snapshot_id","sha256","url"]}},{"name":"audit.anchor","scope":"account","summary":"Once a day, the head of the account's audit hash chain, so a receiver can hold proof outside Watch.","data":{"type":"object","properties":{"seq":{"type":["string","integer"]},"hash":{"type":"string"},"at":{"type":"string"}},"required":["seq","hash","at"]},"type":"audit.anchor","description":"Once a day, the head of the account's audit hash chain, so a receiver can hold proof outside Watch.","data_schema":{"type":"object","properties":{"seq":{"type":["string","integer"]},"hash":{"type":"string"},"at":{"type":"string"}},"required":["seq","hash","at"]}},{"name":"test","scope":"account","summary":"A sample sent on request to check the endpoint and the signature.","data":{"type":"object","properties":{"message":{"type":"string"},"sample":{"type":"object"}},"required":["message"]},"type":"test","description":"A sample sent on request to check the endpoint and the signature.","data_schema":{"type":"object","properties":{"message":{"type":"string"},"sample":{"type":"object"}},"required":["message"]}}],"mcp":{"url":"https://programmable.watch/api/mcp","transport":"streamable-http","tools":[{"name":"list_watchlists","access":"read","description":"The account's watchlists of suppliers, with counts of suppliers watched, to review, and open findings.","inputSchema":{"type":"object","properties":{},"required":[],"additionalProperties":false}},{"name":"find_supplier","access":"read","description":"Find suppliers on the account's watchlists by name, UEI or your ERP's vendor ID. Returns row ids to use with the other tools.","inputSchema":{"type":"object","properties":{"query":{"type":"string","description":"A supplier name or part of one, a 12-character UEI, or a vendor ID"}},"required":["query"],"additionalProperties":false}},{"name":"supplier_status","access":"read","description":"Everything current about one supplier: registration status, open findings, requirement results and open cases.","inputSchema":{"type":"object","properties":{"row_id":{"type":"string","description":"The supplier's row id, from find_supplier"}},"required":["row_id"],"additionalProperties":false}},{"name":"list_findings","access":"read","description":"Findings across the account, newest and most severe first. Possible matches are not findings against a supplier until a person confirms them.","inputSchema":{"type":"object","properties":{"severity":{"type":"string","enum":["critical","warning","info"]},"watchlist_id":{"type":"string","description":"Only this watchlist"},"include_resolved":{"type":"boolean"},"limit":{"type":"number"}},"required":[],"additionalProperties":false}},{"name":"list_cases","access":"read","description":"Cases: findings being worked, each with an owner, a due date and, once closed, a recorded decision.","inputSchema":{"type":"object","properties":{"status":{"type":"string","enum":["active","open","pending_approval","closed"]},"overdue":{"type":"boolean"}},"required":[],"additionalProperties":false}},{"name":"get_case","access":"read","description":"One case with its findings.","inputSchema":{"type":"object","properties":{"case_id":{"type":"string","description":"The case number"}},"required":["case_id"],"additionalProperties":false}},{"name":"requirement_matrix","access":"read","description":"Every supplier a requirement set reaches against every requirement in it, with status and reason per cell.","inputSchema":{"type":"object","properties":{"set_id":{"type":"string","description":"The requirement set id"}},"required":["set_id"],"additionalProperties":false}},{"name":"run_report","access":"read","description":"A standard report: expiring, cases, exceptions, screening, cmmc, cmmc_readiness, small_business or trend.","inputSchema":{"type":"object","properties":{"kind":{"type":"string","enum":["expiring","cases","exceptions","screening","cmmc","cmmc_readiness","small_business","trend"]},"days":{"type":"number"},"from":{"type":"string","description":"YYYY-MM-DD, for screening"},"to":{"type":"string","description":"YYYY-MM-DD, for screening"}},"required":["kind"],"additionalProperties":false}},{"name":"supplier_as_of","access":"read","description":"A supplier as it stood at the end of a past day: what was held, open, decided and required then.","inputSchema":{"type":"object","properties":{"row_id":{"type":"string","description":"The supplier's row id"},"date":{"type":"string","description":"YYYY-MM-DD"}},"required":["row_id","date"],"additionalProperties":false}},{"name":"list_projects","access":"read","description":"The account's projects: contracts and programs, each with its contract number, prime contract, agency, period, requirement set, and counts of suppliers and open findings. Returns project ids to use with project_status.","inputSchema":{"type":"object","properties":{"include_archived":{"type":"boolean"}},"required":[],"additionalProperties":false}},{"name":"project_status","access":"read","description":"One project (a contract or program): its details and instructions, every supplier on it with match status and open findings, the requirement sets it carries, and, given a date, whether each supplier was clean at the end of that day.","inputSchema":{"type":"object","properties":{"project_id":{"type":"string","description":"The project id, from list_projects"},"date":{"type":"string","description":"YYYY-MM-DD (optional): add the as-of answer for every supplier on that day"}},"required":["project_id"],"additionalProperties":false}},{"name":"supplier_by_vendor_id","access":"read","description":"Look a supplier up by your ERP's vendor ID (or its UEI): its status (watching, excepted, needs_review, not_matched, retired, removed), whether it is blocked (do not pay or award) and why.","inputSchema":{"type":"object","properties":{"vendor_id":{"type":"string","description":"Your ERP's vendor ID"},"uei":{"type":"string","description":"Or a 12-character UEI"},"watchlist_id":{"type":"string","description":"Only this watchlist (optional)"}},"required":[],"additionalProperties":false}},{"name":"blocked_suppliers","access":"read","description":"The vendors to block now (do not pay or award): watched suppliers with an open critical finding not under an exception, or on hold by a case. Each with vendor ID, UEI, reasons and since when.","inputSchema":{"type":"object","properties":{},"required":[],"additionalProperties":false}},{"name":"open_case","access":"write","idempotent":false,"overwrites":false,"description":"Open a case on a supplier for a person to work. Needs a full-access key.","inputSchema":{"type":"object","properties":{"row_id":{"type":"string","description":"The supplier's row id"},"title":{"type":"string","description":"What needs doing"},"note":{"type":"string","description":"A first note (optional)"}},"required":["row_id","title"],"additionalProperties":false}},{"name":"add_case_note","access":"write","idempotent":false,"overwrites":false,"description":"Add a note to a case. Needs a full-access key.","inputSchema":{"type":"object","properties":{"case_id":{"type":"string","description":"The case number"},"body":{"type":"string","description":"The note"}},"required":["case_id","body"],"additionalProperties":false}},{"name":"upsert_supplier","access":"write","idempotent":true,"overwrites":true,"description":"Add a supplier, or update the one with this vendor ID (else UEI), as PUT /api/suppliers/by-vendor/{vendor_id} does. Matching confirms only on an exact UEI or CAGE, never on a name. Needs a full-access key.","inputSchema":{"type":"object","properties":{"vendor_id":{"type":"string","description":"Your ERP's vendor ID"},"uei":{"type":"string","description":"12-character UEI"},"cage":{"type":"string","description":"5-character CAGE code"},"name":{"type":"string","description":"The supplier's name (needed to add one)"},"watchlist_id":{"type":"string","description":"Which list (needed to add one when the account has several)"},"state":{"type":"string","description":"Two-letter state"},"city":{"type":"string","description":"City"},"zip":{"type":"string","description":"ZIP"},"website":{"type":"string","description":"Website"},"contact_email":{"type":"string","description":"The supplier's contact email"},"tags":{"type":"array","items":{"type":"string"}},"tier":{"type":"string","enum":["critical","standard","low"]}},"required":[],"additionalProperties":false}}]}}