v1

latestOpenAPI 3.0.0MIT2026-07-17124105392.5 KB
IPFS » Pins

Remove a IPFS pin

Remove pinned objects from local storage

<p> <span class="hosted">Hosted</span> Endpoint only available for hosted variant. </p>

Note: If the object was pinned to Filecoin (using filecoin=true), it cannot be removed or unpinned due to Filecoin's immutable and persistent storage guarantees. Please ensure careful consideration when pinning objects to Filecoin, as the action is irreversible.

post/ipfs/pin/remove/{IPFS_path}

Path parameters

IPFS_pathstring required

The path to the IPFS object

Response

Returns the pins removed

ipfs_hashstring required

IPFS hash of the pinned object

state'queued' | 'pinned' | 'unpinned' | 'failed' | 'gc' required

State of the pin action

Example response

{
  "ipfs_hash": "QmPojRfAXYAXV92Dof7gtSgaVuxEk64xx9CKvprqu9VwA8",
  "state": "unpinned"
}