forget_references
Delete stored reference patterns by exact ID or entire host. Use for takedown requests: permanently remove all records from a site, reporting skipped and failed items.
Instructions
Remove stored patterns from the local corpus — one by ref_id, or every pattern captured from a site. This is the takedown path: if a site asks that their design work not be kept, forget_references({ host: 'their.site', confirm: true }) removes every record and every rendered thumbnail from that host in one call. Host matching is exact plus subdomains ('linear.app' takes 'app.linear.app', never 'notlinear.app'; an IP address matches only itself), and a host-wide removal requires confirm:true because it is not reversible — there is no trash. The refusal names the ref_ids it would remove: pass them back as expected_ref_ids to pin the removal to what you were shown, and anything that appeared since is reported in appeared_since_preview[] rather than deleted. Returns the ref_ids actually removed, so a partial result is visible rather than assumed; records whose JSON could not be parsed are reported in skipped[] and left on disk rather than counted as cleared, and records that could not be deleted are reported separately in failed[]. Local only: it deletes files under the reference home and contacts nobody.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| host | No | Remove every reference captured from this host and its subdomains, e.g. 'linear.app' | |
| ref_id | No | Remove exactly this one reference. Supply this or host. | |
| confirm | No | Required when removing by host — the removal is permanent | |
| expected_ref_ids | No | The ref_ids the confirmation prompt listed. Supplying them pins the removal to that set: anything matching the host that appeared since is reported, not deleted. |