IPFS Pinning Service API

Programmatic access to pin and manage your IPFS content.

Authentication

All API requests require a Bearer token. Create one in API Keys.

Authorization: Bearer YOUR_API_KEY

Endpoints

GET /api/v1/pins

List all your pins.

curl -H "Authorization: Bearer $KEY" https://pinvault.cc/api/v1/pins

Response: [{"id":"...","cid":"Qm...","name":"my-file","status":"pinned","size":1234,"created_at":"..."}]

POST /api/v1/pins

Pin a CID.

curl -X POST -H "Authorization: Bearer $KEY" \
     -H "Content-Type: application/json" \
     -d '{"cid":"QmPZ9gc...","name":"optional-name"}' \
     https://pinvault.cc/api/v1/pins

Response: {"success":true,"id":"...","cid":"Qm..."}

DELETE /api/v1/pins/:id

Unpin content by pin ID.

curl -X DELETE -H "Authorization: Bearer $KEY" https://pinvault.cc/api/v1/pins/PIN_ID

Response: {"success":true}

GET /api/v1/account

Get your account info.

curl -H "Authorization: Bearer $KEY" https://pinvault.cc/api/v1/account

Response: {"username":"...","storage_used":1234,"storage_quota":1073741824,"plan":"starter","plan_status":"active","plan_expires_at":"2026-03-15 12:00:00","pin_count":5}

Rate Limits

API is limited to 60 requests per minute per API key. Pin operations are queued and processed asynchronously.