Skip to main content
PUT
JavaScript

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id
string<uuid>
required

KV namespace ID

key
string
required

Key name. Allowed characters: a-z A-Z 0-9 - _ / = .; maximum 256 characters; names starting with _ are reserved for system use. May contain /. When calling the HTTP API directly, URL-encode the key so the whole string is treated as one key (for example user/1 -> user%2F1). SDK users should pass the key raw - SDKs URL-encode path parameters automatically.

Maximum string length: 256
Pattern: ^[-/_=.a-zA-Z0-9]+$

Query Parameters

ttl_secs
integer<int64>

Time-to-live in seconds. When set, the key expires and is deleted after this duration. Requires a namespace provisioned with TTL support; namespaces without it return a 409.

Required range: 1 <= x <= 9223372036

Body

application/octet-stream

The value to store, sent as the raw request body. Maximum size: 1 MiB (1048576 bytes).

Raw value bytes, stored verbatim.

Response

Key updated