Assistants
- GETList assistants
- POSTCreate assistant
- GETRetrieve assistant
- POSTModify assistant
- DELDelete assistant
- POSTCreate thread
- POSTCreate thread and run
- GETRetrieve thread.
- POSTModify thread
- DELDelete thread
- GETList messages
- POSTCreate message
- GETRetrieve message
- POSTModify message
- DELDelete message
- GETList runs
- POSTCreate run
- GETRetrieve run
- POSTModify run
- POSTCancel run
- GETList run steps
- GETRetrieve run step
- POSTThe run step object
Chat
Completions
Embeddings
Evals
Files
Fine-tuning
- GETList checkpoint permissions
- POSTCreate checkpoint permissions
- DELDelete checkpoint permission
- GETList your organization's fine-tuning jobs
- POSTCreate a fine-tuning job
- GETRetrieve fine-tuning job
- POSTImmediately cancel a fine-tune job.
- GETList checkpoints for a fine-tuning job.
- GETGet status updates for a fine-tuning job.
Moderations
API Reference
Audit Logs
Certificates
Usage
Projects
- GETReturns a list of projects.
- POSTCreate project
- GETRetrieves a project.
- POSTModify project
- GETList project API keys
- GETRetrieve project API key
- DELDelete project API key
- POSTArchive project
- GETList project rate limits
- POSTUpdate project rate limit
- GETList project service accounts
- POSTCreate project service account
- GETRetrieve project service account
- DELDelete project service account
- GETReturn project users
- POSTCreate project user
- GETRetrieve project user
- POSTModify project user
- DELDelete project user
Responses
Vector stores
- GETReturns a list of vector stores.
- POSTCreate a vector store.
- GETRetrieves a vector store.
- POSTModifies a vector store.
- DELDelete a vector store.
- POSTCreate a vector store file batch.
- GETRetrieves a vector store file batch.
- POSTCancel vector store file batch
- GETReturns a list of vector store files in a batch.
- GETReturns a list of vector store files.
- POSTCreate vector store file
- GETRetrieves a vector store file.
- POSTUpdate attributes on a vector store file.
- DELDelete vector store file
- GETRetrieve vector store
- POSTSearch vector store
Vector stores
Create vector store file
Create a vector store file by attaching a File to a vector store.
POST
/
vector_stores
/
{vector_store_id}
/
files
Copy
Ask AI
curl --request POST \
--url https://api.openai.com/v1/vector_stores/{vector_store_id}/files \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"file_id": "<string>",
"chunking_strategy": {
"type": "auto"
},
"attributes": {}
}'
Copy
Ask AI
{
"id": "<string>",
"object": "vector_store.file",
"usage_bytes": 123,
"created_at": 123,
"vector_store_id": "<string>",
"status": "in_progress",
"last_error": {
"code": "server_error",
"message": "<string>"
},
"chunking_strategy": {
"type": "static",
"static": {
"max_chunk_size_tokens": 2098,
"chunk_overlap_tokens": 123
}
},
"attributes": {}
}
Authorizations
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Path Parameters
The ID of the vector store for which to create a File.
Example:
"vs_abc123"
Body
application/json
Response
200 - application/json
OK
A list of files attached to a vector store.
Was this page helpful?
Copy
Ask AI
curl --request POST \
--url https://api.openai.com/v1/vector_stores/{vector_store_id}/files \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"file_id": "<string>",
"chunking_strategy": {
"type": "auto"
},
"attributes": {}
}'
Copy
Ask AI
{
"id": "<string>",
"object": "vector_store.file",
"usage_bytes": 123,
"created_at": 123,
"vector_store_id": "<string>",
"status": "in_progress",
"last_error": {
"code": "server_error",
"message": "<string>"
},
"chunking_strategy": {
"type": "static",
"static": {
"max_chunk_size_tokens": 2098,
"chunk_overlap_tokens": 123
}
},
"attributes": {}
}
Assistant
Responses are generated using AI and may contain mistakes.