Body Parameters

cid

string

REQUIRED

Represents the CID (Content Identifier) that identifies the content to be pinned

name

string

REQUIRED

Specifies the name associated with the pinned object. The length should be less than or equal to 255 characters

origins

array

A list of multi-addresses representing the origins of the pinned object

meta

object

Contains details about the meta information of the pinned object

test

string

Represents a test-related detail about the pinned object

morevalue

object

Contains additional details about the pinned object

location

string

Describes the location associated with the pinned object

Returns

requestId

string

Represents the ID of the request

status

string

Describes the status of the pinned object

cid

string

Represents the CID associated with the pinned object

name

string

Specifies the name associated with the pinned object

origins

string

A list of string values representing the origins of the pinned object

meta

object

Contains details about the meta information of the pinned object

test

string

Represents a test-related detail about the pinned object

morevalue

object

Contains additional details about the pinned object

location

string

Describes the location associated with the pinned object

uuid

string

Represents the UUID (Universally Unique Identifier) of the pinned object

createdAt

string

Specifies the date and time when the pinned object was created

updatedAt

string

Indicates the date and time when the pinned object was last updated

contentType

null

Represents the content type of the pinned object

size

null

Represents the size of the pinned object

Request

1
curl --location 'https://api.quicknode.com/ipfs/rest/v1/pinning' \
2
--header 'x-api-key: YOUR_API_KEY' \
3
--header 'Content-Type: application/json' \
4
--data '  {
5
    "cid": "QmWTqpfKyPJcGuWWg73beJJiL6FrCB5yX8qfcCF4bHanes",
6
    "name": "image.png",
7
    "origins": ["/ip4/123.12.113.142/tcp/4001/p2p/SourcePeerId", "/ip4/123.12.113.114/udp/4001/quic/p2p/SourcePeerId"],
8
    "meta": { "test": "mycooltest", "morevalue": { "location": "/home" } }
9
  }'

1
curl --location 'https://api.quicknode.com/ipfs/rest/v1/pinning' \
2
--header 'x-api-key: YOUR_API_KEY' \
3
--header 'Content-Type: application/json' \
4
--data '  {
5
    "cid": "QmWTqpfKyPJcGuWWg73beJJiL6FrCB5yX8qfcCF4bHanes",
6
    "name": "image.png",
7
    "origins": ["/ip4/123.12.113.142/tcp/4001/p2p/SourcePeerId", "/ip4/123.12.113.114/udp/4001/quic/p2p/SourcePeerId"],
8
    "meta": { "test": "mycooltest", "morevalue": { "location": "/home" } }
9
  }'

1
var myHeaders = new Headers();
2
myHeaders.append("x-api-key", "YOUR_API_KEY");
3
myHeaders.append("Content-Type", "application/json");
4

5
var raw = JSON.stringify({
6
  "cid": "QmWTqpfKyPJcGuWWg73beJJiL6FrCB5yX8qfcCF4bHanes",
7
  "name": "image.png",
8
  "origins": [
9
    "/ip4/123.12.113.142/tcp/4001/p2p/SourcePeerId",
10
    "/ip4/123.12.113.114/udp/4001/quic/p2p/SourcePeerId"
11
  ],
12
  "meta": {
13
    "test": "mycooltest",
14
    "morevalue": {
15
      "location": "/home"
16
    }
17
  }
18
});
19

20
var requestOptions = {
21
  method: 'POST',
22
  headers: myHeaders,
23
  body: raw,
24
  redirect: 'follow'
25
};
26

27
fetch("https://api.quicknode.com/ipfs/rest/v1/pinning", requestOptions)
28
  .then(response => response.text())
29
  .then(result => console.log(result))
30
  .catch(error => console.log('error', error));

1
var myHeaders = new Headers();
2
myHeaders.append("x-api-key", "YOUR_API_KEY");
3
myHeaders.append("Content-Type", "application/json");
4

5
var raw = JSON.stringify({
6
  "cid": "QmWTqpfKyPJcGuWWg73beJJiL6FrCB5yX8qfcCF4bHanes",
7
  "name": "image.png",
8
  "origins": [
9
    "/ip4/123.12.113.142/tcp/4001/p2p/SourcePeerId",
10
    "/ip4/123.12.113.114/udp/4001/quic/p2p/SourcePeerId"
11
  ],
12
  "meta": {
13
    "test": "mycooltest",
14
    "morevalue": {
15
      "location": "/home"
16
    }
17
  }
18
});
19

20
var requestOptions = {
21
  method: 'POST',
22
  headers: myHeaders,
23
  body: raw,
24
  redirect: 'follow'
25
};
26

27
fetch("https://api.quicknode.com/ipfs/rest/v1/pinning", requestOptions)
28
  .then(response => response.text())
29
  .then(result => console.log(result))
30
  .catch(error => console.log('error', error));

1
import requests
2
import json
3

4
url = "https://api.quicknode.com/ipfs/rest/v1/pinning"
5

6
payload = json.dumps({
7
  "cid": "QmWTqpfKyPJcGuWWg73beJJiL6FrCB5yX8qfcCF4bHanes",
8
  "name": "image.png",
9
  "origins": [
10
    "/ip4/123.12.113.142/tcp/4001/p2p/SourcePeerId",
11
    "/ip4/123.12.113.114/udp/4001/quic/p2p/SourcePeerId"
12
  ],
13
  "meta": {
14
    "test": "mycooltest",
15
    "morevalue": {
16
      "location": "/home"
17
    }
18
  }
19
})
20
headers = {
21
  'x-api-key': 'YOUR_API_KEY',
22
  'Content-Type': 'application/json'
23
}
24

25
response = requests.request("POST", url, headers=headers, data=payload)
26

27
print(response.text)
28

1
import requests
2
import json
3

4
url = "https://api.quicknode.com/ipfs/rest/v1/pinning"
5

6
payload = json.dumps({
7
  "cid": "QmWTqpfKyPJcGuWWg73beJJiL6FrCB5yX8qfcCF4bHanes",
8
  "name": "image.png",
9
  "origins": [
10
    "/ip4/123.12.113.142/tcp/4001/p2p/SourcePeerId",
11
    "/ip4/123.12.113.114/udp/4001/quic/p2p/SourcePeerId"
12
  ],
13
  "meta": {
14
    "test": "mycooltest",
15
    "morevalue": {
16
      "location": "/home"
17
    }
18
  }
19
})
20
headers = {
21
  'x-api-key': 'YOUR_API_KEY',
22
  'Content-Type': 'application/json'
23
}
24

25
response = requests.request("POST", url, headers=headers, data=payload)
26

27
print(response.text)
28

1
require "uri"
2
require "json"
3
require "net/http"
4

5
url = URI("https://api.quicknode.com/ipfs/rest/v1/pinning")
6

7
https = Net::HTTP.new(url.host, url.port)
8
https.use_ssl = true
9

10
request = Net::HTTP::Post.new(url)
11
request["x-api-key"] = "YOUR_API_KEY"
12
request["Content-Type"] = "application/json"
13
request.body = JSON.dump({
14
  "cid": "QmWTqpfKyPJcGuWWg73beJJiL6FrCB5yX8qfcCF4bHanes",
15
  "name": "image.png",
16
  "origins": [
17
    "/ip4/123.12.113.142/tcp/4001/p2p/SourcePeerId",
18
    "/ip4/123.12.113.114/udp/4001/quic/p2p/SourcePeerId"
19
  ],
20
  "meta": {
21
    "test": "mycooltest",
22
    "morevalue": {
23
      "location": "/home"
24
    }
25
  }
26
})
27

28
response = https.request(request)
29
puts response.read_body
30

1
require "uri"
2
require "json"
3
require "net/http"
4

5
url = URI("https://api.quicknode.com/ipfs/rest/v1/pinning")
6

7
https = Net::HTTP.new(url.host, url.port)
8
https.use_ssl = true
9

10
request = Net::HTTP::Post.new(url)
11
request["x-api-key"] = "YOUR_API_KEY"
12
request["Content-Type"] = "application/json"
13
request.body = JSON.dump({
14
  "cid": "QmWTqpfKyPJcGuWWg73beJJiL6FrCB5yX8qfcCF4bHanes",
15
  "name": "image.png",
16
  "origins": [
17
    "/ip4/123.12.113.142/tcp/4001/p2p/SourcePeerId",
18
    "/ip4/123.12.113.114/udp/4001/quic/p2p/SourcePeerId"
19
  ],
20
  "meta": {
21
    "test": "mycooltest",
22
    "morevalue": {
23
      "location": "/home"
24
    }
25
  }
26
})
27

28
response = https.request(request)
29
puts response.read_body
30

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free