Sometimes, you may want to delete links. The author, for instance, uses Pinboard as a reference library that sometimes includes links to documents only available on an employer’s VPN. Once that employer has been left, those documents are no longer available (or, frankly, of interest).
One can of course delete links directly, simply by saying pin
delete URL..., but this is likely to prove tedious. Therefore, you
can also delete by tags.
To remove all links with a given tag, say:
pin delete TAG
You can combine tags with the ’+’ symbol; this will select the set of URLs who have all of the tags in the expression:
pin delete TAG1+TAG2+TAG3
will only delete links with all of TAG1, TAG2 and TAG3.
You can freely mix tags & URLs as arguments, like so:
pin delete https://foo.com TAG1+TAG2+TAG3 http://bar.io TAG4
Since the Pinboard API only allows deleting a single post at a time, this sub-command can result in a flood of API invocations subject to rate-limiting, and so this command may take some time to complete. If verbose output has not been requested, a progress bar will be displayed (see Rate Limiting).
If you’d like to just see a list of links that would be deleted, specify the --dry-run flag.