Back

Blog details

What Happens to Your Files If You Stop Using AIOZ Pin

AIOZ Network
4 min readSeptember 28, 2026
aioz-pin

Every pinning service, AIOZ Pin included, is upfront about what it costs to keep files pinned. Almost none are upfront about what actually happens the moment you stop paying. That gap isn't unique to AIOZ Pin, it's an industry-wide documentation blind spot, but it's worth being honest about exactly where that gap is and what you can still control proactively, rather than finding out the hard way after a balance runs out.

TL;DR:

  • AIOZ Pin's own documentation doesn't specify what happens when a wallet balance hits zero, whether pins get removed immediately, after a grace period, or something else, and this is true of most pinning services industry-wide, not an AIOZ-specific gap
  • Because IPFS content is only as available as whoever's actively hosting it, an unpinned file's actual disappearance isn't instant, but it isn't something to plan around either
  • You can export a full, portable backup of everything you've pinned as a CAR file before you ever need to, independent of any single provider
  • The IPFS Pinning Service API standard AIOZ Pin implements means switching providers, or re-pinning the same content somewhere else, doesn't require rebuilding your integration
  • The honest, proactive move is monitoring usage through the Billing API and acting before a balance runs out, not relying on an undocumented grace period that may or may not exist

The Honest Answer: This Isn't Documented

AIOZ Pin's payment documentation covers pricing in detail: storage, bandwidth, pinned-file costs, all clearly specified. What it doesn't cover is what happens once a wallet balance actually reaches zero, whether there's a grace period before pins get removed, a warning threshold, or an immediate effect on pinned content. This isn't a gap specific to AIOZ Pin, it's a pattern across the pinning-service industry generally, most providers document pricing thoroughly and say very little about the actual off-boarding or non-payment sequence. Filling that gap with a confident-sounding guess would be exactly the kind of unverified claim worth avoiding here. The honest position is: don't assume a specific grace period exists, because nothing published confirms one does.

What Actually Happens to a Pin, Mechanically

Separate from AIOZ Pin's own policy, it's worth understanding the underlying mechanics this series covers elsewhere: unpinning doesn't delete content immediately. It removes the content from the protected set, making it eligible for garbage collection the next time it runs, not an instant deletion. And a CID's actual disappearance from the network depends on whether anyone else, on AIOZ Pin's infrastructure or elsewhere, still has it pinned independently. None of that changes the practical reality that you shouldn't count on any of it as a safety net, it's a description of the mechanism, not a guarantee of a grace window you can rely on.

What You Can Actually Control: Export Before You Need To

The one part of this entirely within your control is having your own independent copy of everything you've pinned, well before any cancellation scenario comes up. A CAR file (Content Addressable aRchive) packages an entire DAG, a full directory tree, all its content, into one portable file via ipfs dag export, the same format this series' CAR-files article covers in depth. Exporting your pinset this way means you're never solely dependent on AIOZ Pin's own infrastructure holding the only copy of anything, you have a real, importable backup you could re-pin anywhere that speaks the same protocol.

Why Portability Isn't Just a Slogan Here

AIOZ Pin implements the IPFS Pinning Service API standard, the same specification other providers implement too. That standard existing is what makes "switch providers without rewriting your integration" a real, practical option rather than marketing language, an integration built against the standard API can point at a different compliant provider with a configuration change, not a rebuild. Combined with a CAR-based export of your actual pinned content, that's the real, concrete answer to "what if I need to leave," not a hope that a specific provider's cancellation flow will be generous.

The Proactive Move: Monitor, Don't Wait

Given that zero-balance behavior isn't documented, the practical answer isn't to find out empirically. AIOZ Pin's Billing API exposes current-month usage and historical spend as read endpoints specifically so a project can track its own burn rate and top up before a balance runs low, rather than treating the wallet balance as something to check only after something's already gone wrong. Building a simple, periodic check against that endpoint into your own operations is a five-minute integration that removes the entire question of what happens at zero, because you never actually get there unprepared.

Frequently Asked Questions

What happens to my pinned files if my AIOZ Pin balance hits zero? This isn't publicly documented, by AIOZ Pin or most pinning services generally. Rather than assume a grace period exists, monitor usage proactively and top up before the balance runs out.

Does unpinning delete a file immediately? No. It removes the content from the protected set, and actual deletion only happens the next time garbage collection runs, and only if nothing else references the content. This is a description of the mechanism, not a promise of a safety window.

How do I back up everything I've pinned on AIOZ Pin? Export it as a CAR file using ipfs dag export, which packages an entire pinned DAG into one portable, importable file, independent of any single provider.

Can I move my pinned content to a different pinning service? Yes, in principle. AIOZ Pin implements the standard IPFS Pinning Service API, and combined with a CAR-based export of your content, switching providers doesn't require rebuilding your integration from scratch.

How can I avoid ever running into a zero-balance situation unexpectedly? Use AIOZ Pin's Billing API to monitor current usage and historical spend, and set up your own proactive top-up threshold rather than waiting for a balance to run out.

References

We only send updates when meaningful changes ship, and you can unsubscribe anytime

Related Content

blog thumbnail

IPFS Is Rate-Limiting Public Gateways: What Changes for You

Free public IPFS gateways are being rate-limited on purpose, not as a bug. Here is exactly what IPFS's own blog says is changing, and what to actually do.

4 min readOctober 05, 2026
blog thumbnail

Real-World IPFS Case Studies: Audius and LikeCoin

Two real, documented IPFS deployments, a media platform and a blockchain publisher, and the specific architectural problem each one solved with it.

4 min readOctober 02, 2026
blog thumbnail

How to Host a Static Website on IPFS (and Why Pin It)

Uploading a site to IPFS is the easy part. Here is the full picture: CID, gateway access, a real domain, and the pinning step most tutorials skip.

5 min readSeptember 30, 2026
blog thumbnail

What Happens to Your Files If You Stop Using AIOZ Pin

Cancelling a pinning service is not documented the way it should be, anywhere in the industry. Here is exactly what you can control before you stop paying.

4 min readSeptember 28, 2026
blog thumbnail

Types of IPFS Nodes: The Different Roles, Explained

IPFS node types aren't a full-vs-light weight class the way some blockchains work. They are specific jobs a node opts into. Here is what each one does.

5 min readSeptember 25, 2026
blog thumbnail

IPFS Immutability: Why You Can't Edit a File in Place

IPFS content is immutable by design: change one byte and the CID changes with it. Here is exactly what happens when you edit a file, and why IPNS fixes it.

4 min readSeptember 23, 2026