Skip to content

Add an item to a kv store

POST
/api/v2/organizations/{organization}/projects/{project}/kv/{store_id}/items
curl --request POST \
--url https://dashboard.quantcdn.io/api/v2/organizations/test-org/projects/test-project/kv/0000/items \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{ "key": "user-session-123", "value": "example", "secret": false }'
organization
required
string

Organization identifier

Example
test-org
project
required
string

Project identifier

Example
test-project
store_id
required
string
Example
0000
Media typeapplication/json
object
key
required

Item key

string
Example
user-session-123
value
required

Item value (can be JSON string)

string
secret

Store as secret with KMS encryption. Secrets cannot be retrieved via GET operations (returns [ENCRYPTED]). Ideal for API keys, passwords, and credentials.

boolean

The request has succeeded.

Media typeapplication/json
object
success
boolean
key
string
value
string
Example
{
"success": true,
"key": "user-session-123"
}

The server could not understand the request due to invalid syntax.

Media typeapplication/json
object
message
required

Error message

string
error
required

Error flag

boolean
Example
{
"message": "The requested resource was not found",
"error": true
}

Access is forbidden.

Media typeapplication/json
object
message
required

Error message

string
error
required

Error flag

boolean
Example
{
"message": "The requested resource was not found",
"error": true
}

Validation error.

Media typeapplication/json
object
message
required

Error message

string
error
required

Error flag

boolean
Example
{
"message": "The requested resource was not found",
"error": true
}