Fetch Random Vector - Upstash Documentation

curl $UPSTASH_VECTOR_REST_URL/random \
  -H "Authorization: Bearer $UPSTASH_VECTOR_REST_TOKEN"

curl $UPSTASH_VECTOR_REST_URL/random/ns \
  -H "Authorization: Bearer $UPSTASH_VECTOR_REST_TOKEN"

{
    "result": {
        "id": "id-0",
        "vector": [0.1, 0.2]
    }
}

GET

random

{namespace}

curl $UPSTASH_VECTOR_REST_URL/random \
  -H "Authorization: Bearer $UPSTASH_VECTOR_REST_TOKEN"

curl $UPSTASH_VECTOR_REST_URL/random/ns \
  -H "Authorization: Bearer $UPSTASH_VECTOR_REST_TOKEN"

{
    "result": {
        "id": "id-0",
        "vector": [0.1, 0.2]
    }
}

Request

This endpoint doesn’t require any additional data.

string

default:""

The namespace to use. When no namespace is specified, the default namespace will be used.

The response will be null if the namespace is empty.

string

required

The id of the vector.

number[]

The dense vector value for dense and hybrid indexes.

Object[]

The sparse vector value for sparse and hybrid indexes.

Hide child attributes

number[]

Indices of the non-zero valued dimensions.

number[]

Values of the non-zero valued dimensions.

curl $UPSTASH_VECTOR_REST_URL/random \
  -H "Authorization: Bearer $UPSTASH_VECTOR_REST_TOKEN"

curl $UPSTASH_VECTOR_REST_URL/random/ns \
  -H "Authorization: Bearer $UPSTASH_VECTOR_REST_TOKEN"

{
    "result": {
        "id": "id-0",
        "vector": [0.1, 0.2]
    }
}

⌘I