API reference

API reference · API

Retrieve a vector store file

GET/v1/vector_stores/{id}/files/{fileId}API key

Parameters

Path and query parameters
FieldTypeWhat it is
id (path)requiredstringThe vector store id, vs_ and 24 hex digits.
fileId (path)requiredstringThe file id, as /v1/files gave it.

Answer 200

The file.

Fields of the 200 answer
FieldTypeWhat it is
idstring
object"vector_store.file"
created_atinteger
vector_store_idstring
statusstringOne of "in_progress", "completed", "failed", "cancelled".
usage_bytesinteger
last_errorobject or null
last_error.codestringOne of "server_error", "unsupported_file", "invalid_file".
last_error.messagestring
attributesobject or nullAt most 16 pairs; keys up to 64 characters, values a string up to 512 characters, a number or a boolean.
chunking_strategyobjectauto is 800 tokens overlapping by 400; static takes 100 to 4096 tokens and an overlap of at most half of that.

Errors

  • 400OpenAI shaped error.
  • 401OpenAI shaped error.
  • 402OpenAI shaped error.
  • 403OpenAI shaped error.
  • 404OpenAI shaped error.
  • 429OpenAI shaped error.

Every error answers in one shape, with its type, code and the field it names. The whole list is in the docs' Errors section.

Antimatter