Path parameters

• vector_store_id string Required

  The ID of the vector store that the files belong to.

• batch_id string Required

  The ID of the file batch that the files belong to.

Query parameters

• limit integer

  A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 20.

  Default value is 20.

• order string

  Sort order by the created_at timestamp of the objects. asc for ascending order and desc for descending order.

  Values are asc or desc. Default value is desc.

• after string

  A cursor for use in pagination. after is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include after=obj_foo in order to fetch the next page of the list.

• before string

  A cursor for use in pagination. before is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include before=obj_foo in order to fetch the previous page of the list.

• filter string

  Filter by file status. One of in_progress, completed, failed, cancelled.

  Values are in_progress, completed, failed, or cancelled.

Responses

• 200 application/json

  OK

  Hide response attributes Show response attributes object

  • object string Required
  • data array[object] Required

    A list of files attached to a vector store.

    Hide data attributes Show data attributes object

    • id string Required

      The identifier, which can be referenced in API endpoints.

    • object string Required

      The object type, which is always vector_store.file.

      Value is vector_store.file.

    • usage_bytes integer Required

      The total vector store usage in bytes. Note that this may be different from the original file size.

    • created_at integer Required

      The Unix timestamp (in seconds) for when the vector store file was created.

    • vector_store_id string Required

      The ID of the vector store that the File is attached to.

    • status string Required

      The status of the vector store file, which can be either in_progress, completed, cancelled, or failed. The status completed indicates that the vector store file is ready for use.

      Values are in_progress, completed, cancelled, or failed.

    • last_error object | null Required

      The last error associated with this vector store file. Will be null if there are no errors.

      Hide last_error attributes Show last_error attributes object | null

      • code string Required

        One of server_error or rate_limit_exceeded.

        Values are internal_error, file_not_found, parsing_error, or unhandled_mime_type.

      • message string Required

        A human-readable description of the error.

    • chunking_strategy object

      One of:

      Static Chunking Strategy object Other Chunking Strategy object

      The strategy used to chunk the file.

      Hide attributes Show attributes

      • type string Required

        Always static.

        Value is static.

      • static object Required
        Hide static attributes Show static attributes object

        • max_chunk_size_tokens integer Required

          The maximum number of tokens in each chunk. The default value is 800. The minimum value is 100 and the maximum value is 4096.

          Minimum value is 100, maximum value is 4096.

        • chunk_overlap_tokens integer Required

          The number of tokens that overlap between chunks. The default value is 400.

          Note that the overlap must not exceed half of max_chunk_size_tokens.

        • Additional properties are NOT allowed
      • Additional properties are NOT allowed

      This is returned when the chunking strategy is unknown. Typically, this is because the file was indexed before the chunking_strategy concept was introduced in the API.

      Hide attributes Show attributes

      • type string Required

        Always other.

        Value is other.

      • Additional properties are NOT allowed
  • first_id string Required
  • last_id string Required
  • has_more boolean Required