OpenAI API (unofficial showcase)
GET/vector_stores/{vector_store_id}/files

List files in a vector store

Lists files attached to a vector store, with pagination and an optional status filter. Use after or before to navigate the list, and filter to select files by processing status.

6 parameters
vector_store_idstringrequired
The unique identifier of the vector store whose files to list.
limitintegeroptional
Maximum number of files to return, from 1 to 100. Defaults to 20 when omitted.
Default:20
orderstringoptional
Sort order by creation time: `asc` or `desc`. Defaults to `desc` when omitted.
Allowed:ascdescDefault:desc
afterstringoptional
File ID cursor for retrieving the next page after that file.
beforestringoptional
File ID cursor for retrieving the previous page before that file.
filterstringoptional
Filter files by status: `in_progress`, `completed`, `failed`, or `cancelled`.
Allowed:in_progresscompletedfailedcancelled

4 status codes
200Returns a page containing vector store file objects, pagination cursors, and a `has_more` indicator.
objectstringrequired
dataarray<VectorStoreFiles>required
first_idstringrequired
last_idstringrequired
has_morebooleanrequired
400Returned when the requested file status filter is invalid.
errorobjectrequired
404Returned when the vector store does not exist.
errorobjectrequired
429Returned when the request exceeds a rate limit.
errorobjectrequired

Error handling

A 400 is returned when filter contains an invalid status. A 404 is returned when the vector store does not exist, and a 429 is returned when the request exceeds a rate limit. limit must be between 1 and 100, order must be asc or desc, and filter must be in_progress, completed, failed, or cancelled.