Create Index
This endpoint creates an index.
curl --request POST \
--url https://api.upstash.com/v2/vector/index \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"name": "myindex",
"region": "us-east-1",
"similarity_function": "COSINE",
"dimension_count": 1024,
"type": "payg",
"embedding_model": "BGE_M3"
}'{
"customer_id": "example@upstash.com",
"id": "0639864f-ece6-429c-8118-86a287b0e808",
"name": "myindex",
"similarity_function": "COSINE",
"dimension_count": 384,
"embedding_model": "BGE_SMALL_EN_V1_5",
"sparse_embedding_model": "BM25",
"endpoint": "glowing-baboon-15797-us1",
"token": "QkZGAsWp2tdW0tdC0zNzM1LWV1MkFkNQzB1ExUb3hOekF0TVRJbFpMDNLVSm1GZw==",
"read_only_token": "QkZGRk1heGSKC0MtdRlZC0zNzM1LWTj3pAV0Wm1aZ01p05qY3RNR0U0TkRtRt2s9azJU",
"type": "fixed",
"region": "us-east-1",
"max_vector_count": 5210000,
"max_daily_updates": 1000000,
"max_daily_queries": 1000000,
"max_monthly_bandwidth": -1,
"max_writes_per_second": 1000,
"max_query_per_second": 1000,
"max_reads_per_request": 1000,
"max_writes_per_request": 1000,
"max_total_metadata_size": 53687091200,
"reserved_price": 60,
"creation_time": 1753207106,
"index_type": "DENSE",
"throughput_vector": [
{
"x": "2025-09-04 14:55:00.000 +0000 UTC",
"y": 0
},
{
"x": "2025-09-04 14:56:00.000 +0000 UTC",
"y": 0
}
]
}Authorization
Bearer authentication header of the form Bearer <token>.
Body
Name of the index
Region of the database
Similarity function that's used to calculate the distance between two vectors
The amount of values in a single vector
The payment plan of your index
The embedding model to use for the index
The type of the vector index
The sparse embedding model to be used for indexes
Response
200 — Index created successfully
The associated ID of the owner of the index
Unique ID of the index
The name of the index
Similarity function that's used to calculate the distance between two vectors
The amount of values in a single vector
The predefined embedding model to vectorize your plain text
The sparse embedding model to be used for indexes
The REST endpoint of the index
The REST authentication token for the index
The REST authentication read only token for the index
The payment plan of the index
The region where the index is currently deployed
The number of maximum that your index can contain
The number of maximum update operations you can perform in a day. Only upsert operations are included in update count.
The number of maximum query operations you can perform in a day. Only query operations are included in query count.
The maximum amount of monthly bandwidth for the index. Unit is bytes. -1 if the limit is unlimited.
The number of maximum write operations you can perform per second. Only upsert operations are included in write count.
The number of maximum query operations you can perform per second. Only query operations are included in query count.
The number of maximum vectors in a read operation. Query and fetch operations are included in read operations.
The number of maximum vectors in a write operation. Only upsert operations are included in write operations.
The amount of maximum size for the total metadata sizes in your index.
Monthly pricing of your index. Only available for fixed and pro plans.
The creation time of the vector index in UTC as unix timestamp.
The type of the vector index
Throughput data for the vector index over time