Body Parameters

addValues

object

An object containing key-value pairs to be added

deleteValues

array

An array of strings representing keys to be deleted

Returns

code

number

Response status code

msg

string

Response message

data

null

No additional data

Request

1
curl -X POST \
2
    "https://api.quicknode.com/kv/rest/v1/values/bulk" \
3
    -H "accept: application/json" \
4
    -H "Content-Type: application/json" \
5
    -H "x-api-key: YOUR_API_KEY" \
6
    -d $'{
7
      "addValues": {
8
        "key1": "value1",
9
        "key2": "value2"
10
      },
11
      "deleteValues": [
12
        "key3"
13
      ]
14
    }'
15
    

1
curl -X POST \
2
    "https://api.quicknode.com/kv/rest/v1/values/bulk" \
3
    -H "accept: application/json" \
4
    -H "Content-Type: application/json" \
5
    -H "x-api-key: YOUR_API_KEY" \
6
    -d $'{
7
      "addValues": {
8
        "key1": "value1",
9
        "key2": "value2"
10
      },
11
      "deleteValues": [
12
        "key3"
13
      ]
14
    }'
15
    

1
var myHeaders = new Headers();
2
myHeaders.append('accept', 'application/json');
3
myHeaders.append('Content-Type', 'application/json');
4
myHeaders.append('x-api-key', 'YOUR_API_KEY'); // Replace with your actual API key
5

6
var requestOptions = {
7
  method: 'POST',
8
  headers: myHeaders,
9
  redirect: 'follow',
10
  body: JSON.stringify({
11
    addValues: {
12
      key1: 'value1',
13
      key2: 'value2'
14
    },
15
    deleteValues: ['key3']
16
  })
17
};
18

19
fetch('https://api.quicknode.com/kv/rest/v1/values/bulk', requestOptions)
20
  .then(response => response.text())
21
  .then(result => console.log(result))
22
  .catch(error => console.log('error', error));
23

1
var myHeaders = new Headers();
2
myHeaders.append('accept', 'application/json');
3
myHeaders.append('Content-Type', 'application/json');
4
myHeaders.append('x-api-key', 'YOUR_API_KEY'); // Replace with your actual API key
5

6
var requestOptions = {
7
  method: 'POST',
8
  headers: myHeaders,
9
  redirect: 'follow',
10
  body: JSON.stringify({
11
    addValues: {
12
      key1: 'value1',
13
      key2: 'value2'
14
    },
15
    deleteValues: ['key3']
16
  })
17
};
18

19
fetch('https://api.quicknode.com/kv/rest/v1/values/bulk', requestOptions)
20
  .then(response => response.text())
21
  .then(result => console.log(result))
22
  .catch(error => console.log('error', error));
23

1
import requests
2

3
url = "https://api.quicknode.com/kv/rest/v1/values/bulk"
4

5
payload = {
6
    "addValues": {
7
        "key_1": "value_1",
8
        "key_2": "value_2"
9
    },
10
    "deleteValues": ["key_3"]
11
}
12

13
headers = {
14
    "accept": "application/json",
15
    "Content-Type": "application/json",
16
    "x-api-key": "YOUR_API_KEY"  # Replace with your actual API key
17
}
18

19
response = requests.post(url, headers=headers, json=payload)
20

21
print(response.text)
22

1
import requests
2

3
url = "https://api.quicknode.com/kv/rest/v1/values/bulk"
4

5
payload = {
6
    "addValues": {
7
        "key_1": "value_1",
8
        "key_2": "value_2"
9
    },
10
    "deleteValues": ["key_3"]
11
}
12

13
headers = {
14
    "accept": "application/json",
15
    "Content-Type": "application/json",
16
    "x-api-key": "YOUR_API_KEY"  # Replace with your actual API key
17
}
18

19
response = requests.post(url, headers=headers, json=payload)
20

21
print(response.text)
22

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

5
# Set up the URL for the request
6
url = URI("https://api.quicknode.com/kv/rest/v1/values/bulk")
7

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

11
request = Net::HTTP::Post.new(url)
12
request["accept"] = "application/json"
13
request["Content-Type"] = "application/json"
14
request["x-api-key"] = "YOUR_API_KEY"  # Replace with your actual API key
15

16
request.body = {
17
  "addValues" => {
18
    "key_1" => "value_1",
19
    "key_2" => "value_2"
20
  },
21
  "deleteValues" => [
22
    "key_3"
23
  ]
24
}.to_json
25

26
response = https.request(request)
27
puts response.body
28

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

5
# Set up the URL for the request
6
url = URI("https://api.quicknode.com/kv/rest/v1/values/bulk")
7

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

11
request = Net::HTTP::Post.new(url)
12
request["accept"] = "application/json"
13
request["Content-Type"] = "application/json"
14
request["x-api-key"] = "YOUR_API_KEY"  # Replace with your actual API key
15

16
request.body = {
17
  "addValues" => {
18
    "key_1" => "value_1",
19
    "key_2" => "value_2"
20
  },
21
  "deleteValues" => [
22
    "key_3"
23
  ]
24
}.to_json
25

26
response = https.request(request)
27
puts response.body
28

1
qn kv set bulk --add k1=v1 --add k2=v2 --delete old-key -o json

1
qn kv set bulk --add k1=v1 --add k2=v2 --delete old-key -o json

1
import { QuicknodeSdk } from "@quicknode/sdk"
2

3
const qn = new QuicknodeSdk({ apiKey: "YOUR_API_KEY" })
4

5
const response = await qn.kvstore.bulkSets({ addSets: { cursor: "12345" }, deleteSets: ["old-cursor"] })
6
console.log(response)
7

1
import { QuicknodeSdk } from "@quicknode/sdk"
2

3
const qn = new QuicknodeSdk({ apiKey: "YOUR_API_KEY" })
4

5
const response = await qn.kvstore.bulkSets({ addSets: { cursor: "12345" }, deleteSets: ["old-cursor"] })
6
console.log(response)
7

1
import asyncio
2
from quicknode_sdk import QuicknodeSdk, SdkFullConfig
3

4

5
async def main():
6
    qn = QuicknodeSdk(SdkFullConfig(api_key="YOUR_API_KEY"))
7
    response = await qn.kvstore.bulk_sets(add_sets={"cursor": "12345"}, delete_sets=["old-cursor"])
8
    print(response)
9

10

11
asyncio.run(main())
12

1
import asyncio
2
from quicknode_sdk import QuicknodeSdk, SdkFullConfig
3

4

5
async def main():
6
    qn = QuicknodeSdk(SdkFullConfig(api_key="YOUR_API_KEY"))
7
    response = await qn.kvstore.bulk_sets(add_sets={"cursor": "12345"}, delete_sets=["old-cursor"])
8
    print(response)
9

10

11
asyncio.run(main())
12

1
require "quicknode_sdk"
2

3
qn = QuicknodeSdk::SDK.from_config(api_key: "YOUR_API_KEY")
4

5
response = qn.kvstore.bulk_sets(add_sets: { cursor: "12345" }, delete_sets: ["old-cursor"])
6
puts response
7

1
require "quicknode_sdk"
2

3
qn = QuicknodeSdk::SDK.from_config(api_key: "YOUR_API_KEY")
4

5
response = qn.kvstore.bulk_sets(add_sets: { cursor: "12345" }, delete_sets: ["old-cursor"])
6
puts response
7

1
use quicknode_sdk::{QuicknodeSdk, SdkFullConfig};
2

3
#[tokio::main]
4
async fn main() -> Result<(), Box<dyn std::error::Error>> {
5
    let qn = QuicknodeSdk::new(&SdkFullConfig::builder().api_key("YOUR_API_KEY").build())?;
6
    let response = qn.kvstore.bulk_sets(&quicknode_sdk::kvstore::BulkSetsParams { add_sets: None, delete_sets: Some(vec!["old-cursor".to_string()]) }).await?;
7

8
    println!("{:?}", response);
9
    Ok(())
10
}
11

1
use quicknode_sdk::{QuicknodeSdk, SdkFullConfig};
2

3
#[tokio::main]
4
async fn main() -> Result<(), Box<dyn std::error::Error>> {
5
    let qn = QuicknodeSdk::new(&SdkFullConfig::builder().api_key("YOUR_API_KEY").build())?;
6
    let response = qn.kvstore.bulk_sets(&quicknode_sdk::kvstore::BulkSetsParams { add_sets: None, delete_sets: Some(vec!["old-cursor".to_string()]) }).await?;
7

8
    println!("{:?}", response);
9
    Ok(())
10
}
11

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free