Getting Started

If you do not have a vector database already, follow these steps to create one.

In the database details section of the Upstash Console, scroll down to Connect section and select the cURL tab. You can simply copy the curl expression and run on your terminal.

curl $UPSTASH_VECTOR_REST_URL/upsert \
  -H "Authorization: Bearer $UPSTASH_VECTOR_REST_TOKEN" \
  -d '{"id": "id-0", "vector": [0.87, 0.99]}'

Response

REST API returns a JSON response. When command execution is successful, response JSON will have a single result field and its value will contain the Redis response.

Example:

{ "result": "Success" }

When command execution is not successful, response JSON will have a single error field and its value will contain the error message.

Example:

{
  "error": "Unauthorized: Invalid auth token",
  "status": 401
}

HTTP Response Codes

Status Code	Description
200 OK	When request is accepted and successfully executed.
400 Bad Request	When there’s a syntax error, an invalid/unsupported command is sent or command execution fails.
401 Unauthorized	When authentication fails; auth token is missing or invalid.
405 Method Not Allowed	When an unsupported HTTP method is used. Only HEAD, GET, POST, and PUT methods are allowed.

---