ipfs/kubo · error

multiple remote pins are matching this query, add --force to

Error message

multiple remote pins are matching this query, add --force to confirm the bulk removal

What it means

Safety confirmation for 'ipfs pin remote rm': the filter query matched more than one remote pin, and removing several pins at once requires explicit --force. Without it, only single-pin matches are auto-removed.

Source

Thrown at core/commands/pin/remotepin.go:442

		}

		psCh := make(chan pinclient.PinStatusGetter)
		errCh := make(chan error, 1)
		ctx, cancel := context.WithCancel(req.Context)
		defer cancel()

		go func() {
			errCh <- lsRemote(ctx, req, c, psCh)
		}()
		for ps := range psCh {
			rmIDs = append(rmIDs, ps.GetRequestId())
		}
		if err = <-errCh; err != nil {
			return fmt.Errorf("error while listing remote pins: %v", err)
		}

		if len(rmIDs) > 1 && !req.Options[pinForceOptionName].(bool) {
			return fmt.Errorf("multiple remote pins are matching this query, add --force to confirm the bulk removal")
		}

		for _, rmID := range rmIDs {
			if err = c.DeleteByID(ctx, rmID); err != nil {
				return fmt.Errorf("removing pin identified by requestid=%q failed: %v", rmID, err)
			}
		}
		return nil
	},
}

// remote service commands

var addRemotePinServiceCmd = &cmds.Command{
	Helptext: cmds.HelpText{
		Tagline:          "Add remote pinning service.",
		ShortDescription: "Add credentials for access to a remote pinning service.",
		LongDescription: `

View on GitHub (pinned to 329838acdf)

Solutions

1. Narrow the query (add --requestid or a more specific --name/--cid) so exactly one pin matches
2. Re-run with --force if you really intend to bulk-remove all matching pins

When it happens

Trigger: Thrown at core/commands/pin/remotepin.go:442 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of ipfs/kubo@329838acdf (2026-09-03). Data as JSON: /api/errors/195f9c902a27e851. Report an issue: GitHub.