Path Parameters

requestId

string

REQUIRED

Represents the ID of the request associated with the pinned object that needs to be updated, which can be obtained from querying all pinned object by using 'Get All PinnedObjects' method

Body Parameters

cid

string

REQUIRED

Represents the Content Identifier (CID) that identifies the pinned object

name

string

REQUIRED

Specifies the new name associated with the pinned object. The length of the name 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 updated metadata 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 updated location associated with the pinned object

Returns

requestId

string

Represents the ID of the request

status

string

Describes the status of the pinned object after the update

cid

string

Represents the CID associated with the pinned object

name

string

Specifies the updated 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 updated metadata 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 updated 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 --request PATCH 'https://api.quicknode.com/ipfs/rest/v1/pinning/{requestId}' \
2
--header 'x-api-key: YOUR_API_KEY' \
3
--header 'Content-Type: application/json' \
4
--data '  {
5
    "cid": "QmWTqpfKyPJcGuWWg73beJJiL6FrCB5yX8qfcCF4bHanes",
6
    "name": "newimage.png",
7
    "origins": [],
8
    "meta": { "test": "my meta data" }
9
  }'

1
curl --location --request PATCH 'https://api.quicknode.com/ipfs/rest/v1/pinning/{requestId}' \
2
--header 'x-api-key: YOUR_API_KEY' \
3
--header 'Content-Type: application/json' \
4
--data '  {
5
    "cid": "QmWTqpfKyPJcGuWWg73beJJiL6FrCB5yX8qfcCF4bHanes",
6
    "name": "newimage.png",
7
    "origins": [],
8
    "meta": { "test": "my meta data" }
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": "newimage.png",
8
  "origins": [],
9
  "meta": {
10
    "test": "my meta data"
11
  }
12
});
13

14
var requestOptions = {
15
  method: 'PATCH',
16
  headers: myHeaders,
17
  body: raw,
18
  redirect: 'follow'
19
};
20

21
fetch("https://api.quicknode.com/ipfs/rest/v1/pinning/{requestId}", requestOptions)
22
  .then(response => response.text())
23
  .then(result => console.log(result))
24
  .catch(error => console.log('error', error));
25

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": "newimage.png",
8
  "origins": [],
9
  "meta": {
10
    "test": "my meta data"
11
  }
12
});
13

14
var requestOptions = {
15
  method: 'PATCH',
16
  headers: myHeaders,
17
  body: raw,
18
  redirect: 'follow'
19
};
20

21
fetch("https://api.quicknode.com/ipfs/rest/v1/pinning/{requestId}", requestOptions)
22
  .then(response => response.text())
23
  .then(result => console.log(result))
24
  .catch(error => console.log('error', error));
25

1
import requests
2
import json
3

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

6
payload = json.dumps({
7
  "cid": "QmWTqpfKyPJcGuWWg73beJJiL6FrCB5yX8qfcCF4bHanes",
8
  "name": "newimage.png",
9
  "origins": [],
10
  "meta": {
11
    "test": "my meta data"
12
  }
13
})
14
headers = {
15
  'x-api-key': 'YOUR_API_KEY',
16
  'Content-Type': 'application/json'
17
}
18

19
response = requests.request("PATCH", url, headers=headers, data=payload)
20

21
print(response.text)
22

1
import requests
2
import json
3

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

6
payload = json.dumps({
7
  "cid": "QmWTqpfKyPJcGuWWg73beJJiL6FrCB5yX8qfcCF4bHanes",
8
  "name": "newimage.png",
9
  "origins": [],
10
  "meta": {
11
    "test": "my meta data"
12
  }
13
})
14
headers = {
15
  'x-api-key': 'YOUR_API_KEY',
16
  'Content-Type': 'application/json'
17
}
18

19
response = requests.request("PATCH", url, headers=headers, data=payload)
20

21
print(response.text)
22

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

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

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

10
request = Net::HTTP::Patch.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": "newimage.png",
16
  "origins": [],
17
  "meta": {
18
    "test": "my meta data"
19
  }
20
})
21

22
response = https.request(request)
23
puts response.read_body
24

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

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

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

10
request = Net::HTTP::Patch.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": "newimage.png",
16
  "origins": [],
17
  "meta": {
18
    "test": "my meta data"
19
  }
20
})
21

22
response = https.request(request)
23
puts response.read_body
24

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free