IPNS names

Legacy: This page documents Filebase's IPFS tier. For new deployments, use the S3-compatible object storage tier with the s3.filebase.io endpoint.

IPNS (InterPlanetary Name System) provides a stable, mutable pointer that resolves to a CID. Update the IPNS record when your underlying content changes; consumers reading the IPNS name always get the latest CID.

Common IPNS use cases:

• Mutable websites — your IPNS name stays the same; you republish to a new CID on each deploy.
• Versioned data — point an IPNS name at the latest snapshot.

Plan limits

Plan	IPNS names allowed
Free	1
Starter	100
Pro	1,000
Unlimited	Unlimited

Manage IPNS via the Platform API

List names

curl -H "Authorization: Bearer $(echo -n "$KEY:$SECRET" | base64)" \
  https://api.filebase.io/v1/names

Create a name

curl -X POST \
  -H "Authorization: Bearer $(echo -n "$KEY:$SECRET" | base64)" \
  -H "Content-Type: application/json" \
  -d '{ "label": "my-site", "cid": "<CID>" }' \
  https://api.filebase.io/v1/names

The response includes a network_key — the IPNS pubkey itself, in k51... format.

Update a name

curl -X PUT \
  -H "Authorization: Bearer $(echo -n "$KEY:$SECRET" | base64)" \
  -H "Content-Type: application/json" \
  -d '{ "cid": "<NEW-CID>" }' \
  https://api.filebase.io/v1/names/my-site

Delete a name

curl -X DELETE \
  -H "Authorization: Bearer $(echo -n "$KEY:$SECRET" | base64)" \
  https://api.filebase.io/v1/names/my-site

Resolve an IPNS name

https://ipfs.filebase.io/ipns/<network_key>

TTL and validity

Setting	Value
IPNS TTL	5 minutes
IPNS Validity	48 hours
Propagation time	Typically under 1 minute

What's next

• Filebase Sites — IPNS-backed static-site hosting
• Managing dedicated gateways