Skip to main content
POST
/
files
/
private
/
download_link
Create Download Link
curl --request POST \
  --url https://api.pinata.cloud/v3/files/private/download_link \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "url": "https://example.mypinata.cloud/files/bafybeifq444z4b7yqzcyz4a5gspb2rpyfcdxp3mrfpigmllh52ld5tyzwm",
  "expires": 500000,
  "date": 1724875300,
  "method": "GET"
}
'
{
  "data": "https://blush-fast-impala-660.mypinata.cloud/files/bafybeifq444z4b7yqzcyz4a5gspb2rpyfcdxp3mrfpigmllh52ld5tyzwm?X-Algorithm=PINATA1&X-Date=1724875300&X-Expires=500000&X-Method=GET&X-Signature=example-signature"
}

Documentation Index

Fetch the complete documentation index at: https://docs.pinata.cloud/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
url
string

The full URL of your file in the format of https://{yourgatewaydomain}.mypinata.cloud/files/{cid}

​
date
number

The unix timestamp that the URL is signed, ie time of request

​
expires
number

How long the URL is valid for in sconds after signing based on the date parameter

​
method
string

The URL method, ie GET

Response

200 - application/json

OK

​
data
string

The signed URL