Using

Permanently removes a key from the domain. The operation is idempotent; deleting a non-existent key still returns 204. `If-Match` makes the delete conditional on the version read.

applies to v0.5.1

DELETE

/store-api/kv/{domain}/keys/{key}

const url = 'https://example.com/store-api/kv/example/keys/example';
const options = {method: 'DELETE', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request DELETE \
  --url https://example.com/store-api/kv/example/keys/example \
  --header 'Authorization: Bearer <token>'

Authorizations

bearer_auth

Parameters

Path Parameters

domain

required

string

Domain name

key

required

string

Key (valid UTF-8, max 256 bytes)

Header Parameters

If-Match

string | null

ETag from a prior read: delete only if it is still the key’s current version, else 412

If-None-Match

string | null

Only *: delete only if the key does not exist, else 412. Evaluated after If-Match

Responses

204

Key deleted

400

Invalid key, or invalid If-Match / If-None-Match header

text/plain

string

410

Domain is being deleted

text/plain

string

412

If-Match or If-None-Match does not hold; nothing was deleted

text/plain

string

Headers

ETag

string

ETag of the key’s current version; absent when the key does not exist

428

The domain requires conditional writes and neither If-Match nor If-None-Match is set

text/plain

string

Headers

Cache-Control

string

No-store

429

Rate limit exceeded

text/plain

string

Headers

Retry-After

integer format: int64

507

Insufficient Storage — disk space or memory runs short; the write was not applied. Reads go on; retry after the seconds in Retry-After.

text/plain

string

Headers

Retry-After

integer