Pinata Docs
Search…
Pinata Submarine API
Submarining is the process of uploading content that remains private and off the public IPFS network. You can read more about why Pinata developed this solution here. With Pinata Submarine, you can keep content private and generate access tokens programmatically that last for as long as you specify.
This API can be used for uploading files and folders, listing content, and generating access tokens to view and download content.
Viewing Submarined content requires a Dedicated Gateway. When viewing Submarined content through a Dedicated Gateway, you must include a valid access token. The access token can be generated using this API method. This is how you should construct a link to view Submarined content:
Single File
GATEWAY_URL/ipfs/FILE_CID?accessToken=TOKEN
File Within a Folder
GATEWAYURL/ipfs/FOLDER_CID/FILE_NAME?accessToken=TOKEN
Copy link