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 CodeDescription
200 OKWhen request is accepted and successfully executed.
400 Bad RequestWhen there’s a syntax error, an invalid/unsupported command is sent or command execution fails.
401 UnauthorizedWhen authentication fails; auth token is missing or invalid.
405 Method Not AllowedWhen an unsupported HTTP method is used. Only HEAD, GET, POST, and PUT methods are allowed.