Manage Pin Metadata
Attach key-value pairs to your pins for organisation and search.
Set metadata
pinner pins update bafybeig... --meta project=acme --meta env=prodimport { Pinner } from "@lumeweb/pinner";
const pinner = new Pinner({ jwt: process.env.PINNER_AUTH_TOKEN! });
await pinner.pins.setMetadata(cid, { project: "acme", env: "prod" });Clear metadata
Use --clear-meta to remove all existing metadata before setting new values.
# Clear all metadata
pinner pins update bafybeig... --clear-meta
# Clear and set fresh values in one command
pinner pins update bafybeig... --clear-meta --meta fresh=start// Clear all metadata by passing undefined
await pinner.pins.setMetadata(cid, undefined);Read metadata
pinner pins status bafybeig...const pin = await pinner.pins.get(cid);
console.log(pin.metadata);