Skip to content
Console
On this page

List push in KV

Pushes values onto the head of a list (LPUSH), creating it.

Pushes values onto the head of a list (LPUSH), creating it.

  • Path POST https://api.data.sylphx.com/v1/kv-list-pushes
  • Scope data:write
  • Effect write — a successful call changes state.
  • Collection kv
  • Host https://api.data.sylphx.com

Request

FieldTypeWhat it is
namespace_idstringThe namespace's id. Required.
keystringThe list's key. Required.
valuesbytes[]The values to push, each base64, pushed in order (the last ends first). Required.

Response

FieldTypeWhat it is
lengthuint64The list's length after the push.
versionuint64The list's version after the push.

Errors

Every error arrives in the body Errors describes.

Examples

curl -X POST "https://api.data.sylphx.com/v1/kv-list-pushes" \
  -H "Authorization: Bearer $SYLPHX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"key":"…","namespace_id":"…","values":["…"]}'