Body Parameters

key

string

REQUIRED

A unique identifier for the value

value

string

REQUIRED

The value associated with the specified key

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" \
3
    -H "accept: application/json" \
4
    -H "Content-Type: application/json" \
5
    -H "x-api-key: YOUR_API_KEY" \
6
    -d $'{
7
  "key": "key_1",
8
  "value": "value_1"
9
}'
10
    

1
curl -X POST \
2
    "https://api.quicknode.com/kv/rest/v1/values" \
3
    -H "accept: application/json" \
4
    -H "Content-Type: application/json" \
5
    -H "x-api-key: YOUR_API_KEY" \
6
    -d $'{
7
  "key": "key_1",
8
  "value": "value_1"
9
}'
10
    

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
    key: 'key_1',
12
    value: 'value_1'
13
  })
14
};
15

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

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
    key: 'key_1',
12
    value: 'value_1'
13
  })
14
};
15

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

1
import requests
2

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

5
payload = {
6
    "key": "key_1",
7
    "value": "value_1"
8
}
9

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

16
response = requests.post(url, headers=headers, json=payload)
17

18
print(response.text)
19

1
import requests
2

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

5
payload = {
6
    "key": "key_1",
7
    "value": "value_1"
8
}
9

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

16
response = requests.post(url, headers=headers, json=payload)
17

18
print(response.text)
19

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")
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
  "key" => "key_1",
18
  "value" => "value_1"
19
}.to_json
20

21
response = https.request(request)
22
puts response.body
23

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")
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
  "key" => "key_1",
18
  "value" => "value_1"
19
}.to_json
20

21
response = https.request(request)
22
puts response.body
23

1
qn kv set put {key} {value} -o json

1
qn kv set put {key} {value} -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.createSet({ key: "cursor", value: "12345" })
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.createSet({ key: "cursor", value: "12345" })
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.create_set("cursor", "12345")
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.create_set("cursor", "12345")
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.create_set(key: "cursor", value: "12345")
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.create_set(key: "cursor", value: "12345")
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.create_set(&quicknode_sdk::kvstore::CreateSetParams { key: "cursor".to_string(), value: "12345".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.create_set(&quicknode_sdk::kvstore::CreateSetParams { key: "cursor".to_string(), value: "12345".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