How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Portkey Vector Stores API

The Vector Stores API from Portkey — 8 operation(s) for vector stores.

Portkey Vector Stores API is one of 51 APIs that Portkey publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Vector Stores. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, and a getting-started guide.

This API exposes 13 operations across 8 paths, and defines 18 schemas. It is described by OpenAPI 3.2.0, at version 2.0.0.

Requests are made against a single base URL, https://api.portkey.ai/v1.

13 operations 8 paths 18 schemas 2 DELETE6 GET5 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
2.0.0
Base URL
https://api.portkey.ai/v1
Authentication
API Key, API Key, HTTP Bearer, API Key, API Key, API Key
License
Terms of Service
Resource Areas
1

Authentication & Security 6

Portkey Vector Stores API declares 6 security schemes for authenticating requests. An API key is passed in the header as x-portkey-api-key (Portkey-Key). An API key is passed in the header as x-portkey-virtual-key (Virtual-Key). It accepts HTTP bearer tokens (Provider-Auth). An API key is passed in the header as x-portkey-provider (Provider-Name). An API key is passed in the header as x-portkey-config (Config). An API key is passed in the header as x-portkey-custom-host (Custom-Host). By default, every request must be authenticated.

Paths & Operations 13

Across 8 paths, the API surfaces 13 operations — 2 DELETE, 6 GET, 5 POST. Each is listed below with its method, path, parameters, and response codes.

Vector Stores 13
GET
/vector_stores
Returns a list of vector stores.
listVectorStores 4 params → 200
POST
/vector_stores
Create a vector store.
createVectorStore body → 200
GET
/vector_stores/{vector_store_id}
Retrieves a vector store.
getVectorStore 1 param → 200
POST
/vector_stores/{vector_store_id}
Modifies a vector store.
modifyVectorStore 1 param body → 200
DELETE
/vector_stores/{vector_store_id}
Delete a vector store.
deleteVectorStore 1 param → 200
GET
/vector_stores/{vector_store_id}/files
Returns a list of vector store files.
listVectorStoreFiles 6 params → 200
POST
/vector_stores/{vector_store_id}/files
Create a vector store file by attaching a [File](https://platform.openai.com/docs/api-reference/files) to a [vector store](https://platform.openai.com/docs/api-reference/vector-stores/object).
createVectorStoreFile 1 param body → 200
GET
/vector_stores/{vector_store_id}/files/{file_id}
Retrieves a vector store file.
getVectorStoreFile 2 params → 200
DELETE
/vector_stores/{vector_store_id}/files/{file_id}
Delete a vector store file. This will remove the file from the vector store but the file itself will not be deleted. To delete the file, use the [delete file](https://platform.openai.com/docs/api-ref…
deleteVectorStoreFile 2 params → 200
POST
/vector_stores/{vector_store_id}/file_batches
Create a vector store file batch.
createVectorStoreFileBatch 1 param body → 200
GET
/vector_stores/{vector_store_id}/file_batches/{batch_id}
Retrieves a vector store file batch.
getVectorStoreFileBatch 2 params → 200
POST
/vector_stores/{vector_store_id}/file_batches/{batch_id}/cancel
Cancel a vector store file batch. This attempts to cancel the processing of files in this batch as soon as possible.
cancelVectorStoreFileBatch 2 params → 200
GET
/vector_stores/{vector_store_id}/file_batches/{batch_id}/files
Returns a list of vector store files in a batch.
listFilesInVectorStoreBatch 7 params → 200

Schemas 18

The contract defines 18 schemas that model the data the API accepts and returns. The most detailed are VectorStoreObject (11 properties), VectorStoreFileObject (8 properties), VectorStoreFileBatchObject (6 properties), ListVectorStoresResponse (5 properties). Each schema is shown below with its type and property counts.

DeleteVectorStoreFileResponse
object
3 properties 3 required
ListVectorStoresResponse
object
5 properties 5 required
ListVectorStoreFilesResponse
object
5 properties 5 required
StaticChunkingStrategyRequestParam
object
2 properties 2 required
UpdateVectorStoreRequest
object
3 properties
CreateVectorStoreFileBatchRequest
object
2 properties 1 required
StaticChunkingStrategyResponseParam
object
2 properties 2 required
ChunkingStrategyRequestParam
object
The chunking strategy used to chunk the file(s). If not set, will use the auto strategy.
CreateVectorStoreFileRequest
object
2 properties 1 required
DeleteVectorStoreResponse
object
3 properties 3 required
VectorStoreExpirationAfter
object
The expiration policy for a vector store.
2 properties 2 required
CreateVectorStoreRequest
object
5 properties
VectorStoreFileObject
object
A list of files attached to a vector store.
8 properties 7 required
VectorStoreObject
object
A vector store is a collection of processed files can be used by the filesearch tool.
11 properties 9 required
AutoChunkingStrategyRequestParam
object
The default strategy. This strategy currently uses a maxchunksizetokens of 800 and chunkoverlaptokens of 400.
1 property 1 required
VectorStoreFileBatchObject
object
A batch of files attached to a vector store.
6 properties 6 required
StaticChunkingStrategy
object
2 properties 2 required
OtherChunkingStrategyResponseParam
object
This is returned when the chunking strategy is unknown. Typically, this is because the file was indexed before the chunkingstrategy concept was introduced in t…
1 property 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

portkey-vector-stores-api-openapi.yml Raw ↑

Other APIs Portkey publishes across the network.

Portkey Analytics > Graphs API
Portkey Analytics > Groups API
Portkey Analytics > Summary API
Portkey Api-Keys API
Portkey Assistants API
Portkey Audio API
Portkey Audit Logs API
Portkey Batch API
Portkey Chat API
Portkey Collections API
Portkey Completions API
Portkey Configs API
Where this information came from

This is an independent, third-party profile of Portkey Vector Stores API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.