Create a vector store file by attaching a [File](/docs/api-reference/files) to a [vector store](/docs/api-reference/vector-stores/object).

POST /vector_stores/{vector_store_id}/files

Path parameters

  • vector_store_id string Required

    The ID of the vector store for which to create a File.

application/json

Body Required

  • file_id string Required

    A File ID that the vector store should use. Useful for tools like file_search that can access files.

  • chunking_strategy object

    The chunking strategy used to chunk the file(s). If not set, will use the auto strategy.

    One of:

    The default strategy. This strategy currently uses a max_chunk_size_tokens of 800 and chunk_overlap_tokens of 400.

    Hide attribute Show attribute
    • type string Required

      Always auto.

      Value is auto.

  • attributes object | null

    Set of 16 key-value pairs that can be attached to an object. This can be useful for storing additional information about the object in a structured format, and querying for objects via API or the dashboard. Keys are strings with a maximum length of 64 characters. Values are strings with a maximum length of 512 characters, booleans, or numbers.

Responses

  • 200 application/json

    OK

    Hide response attributes Show response 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 server_error, unsupported_file, or invalid_file.

      • message string Required

        A human-readable description of the error.

    • chunking_strategy object

      The strategy used to chunk the file.

      One of:
      Hide attributes Show attributes
      • type string Required

        Always static.

        Value is static.

      • static object Required

        Additional properties are NOT allowed.

        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.

    • attributes object | null

      Set of 16 key-value pairs that can be attached to an object. This can be useful for storing additional information about the object in a structured format, and querying for objects via API or the dashboard. Keys are strings with a maximum length of 64 characters. Values are strings with a maximum length of 512 characters, booleans, or numbers.

POST /vector_stores/{vector_store_id}/files
curl \
 --request POST 'https://api.openai.com/v1/vector_stores/vs_abc123/files' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "Content-Type: application/json" \
 --data '{"file_id":"string","chunking_strategy":{"type":"auto"},"attributes":{}}'
Request examples
{
  "file_id": "string",
  "chunking_strategy": {
    "type": "auto"
  },
  "attributes": {}
}
Response examples (200)
{
  "id": "string",
  "object": "vector_store.file",
  "usage_bytes": 42,
  "created_at": 42,
  "vector_store_id": "string",
  "status": "in_progress",
  "last_error": {
    "code": "server_error",
    "message": "string"
  },
  "chunking_strategy": {
    "type": "static",
    "static": {
      "max_chunk_size_tokens": 42,
      "chunk_overlap_tokens": 42
    }
  },
  "attributes": {}
}