docs(api): update file parameter descriptions in vector_stores files and file_batches

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 152
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/openai%2Fopenai-00994178cc8e20d71754b00c54b0e4f5b4128e1c1cce765e9b7d696bd8c80d33.yml
-openapi_spec_hash: 81f404053b663f987209b4fb2d08a230
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/openai%2Fopenai-24647ccd7356fee965aaca347476460727c6aec762e16a9eb41950d6fbccf0be.yml
+openapi_spec_hash: ef99e305f20ae8ae7b2758a205280cca
 config_hash: 5635033cdc8c930255f8b529a78de722

src/openai/resources/vector_stores/file_batches.py

@@ -79,14 +79,16 @@ def create(
           file_ids: A list of [File](https://platform.openai.com/docs/api-reference/files) IDs that
               the vector store should use. Useful for tools like `file_search` that can access
               files. If `attributes` or `chunking_strategy` are provided, they will be applied
-              to all files in the batch. The maximum batch size is 2000 files. Mutually
-              exclusive with `files`.
+              to all files in the batch. The maximum batch size is 2000 files. This endpoint
+              is recommended for multi-file ingestion and helps reduce per-vector-store write
+              request pressure. Mutually exclusive with `files`.
 
           files: A list of objects that each include a `file_id` plus optional `attributes` or
               `chunking_strategy`. Use this when you need to override metadata for specific
               files. The global `attributes` or `chunking_strategy` will be ignored and must
-              be specified for each file. The maximum batch size is 2000 files. Mutually
-              exclusive with `file_ids`.
+              be specified for each file. The maximum batch size is 2000 files. This endpoint
+              is recommended for multi-file ingestion and helps reduce per-vector-store write
+              request pressure. Mutually exclusive with `file_ids`.
 
           extra_headers: Send extra headers
 
@@ -452,14 +454,16 @@ async def create(
           file_ids: A list of [File](https://platform.openai.com/docs/api-reference/files) IDs that
               the vector store should use. Useful for tools like `file_search` that can access
               files. If `attributes` or `chunking_strategy` are provided, they will be applied
-              to all files in the batch. The maximum batch size is 2000 files. Mutually
-              exclusive with `files`.
+              to all files in the batch. The maximum batch size is 2000 files. This endpoint
+              is recommended for multi-file ingestion and helps reduce per-vector-store write
+              request pressure. Mutually exclusive with `files`.
 
           files: A list of objects that each include a `file_id` plus optional `attributes` or
               `chunking_strategy`. Use this when you need to override metadata for specific
               files. The global `attributes` or `chunking_strategy` will be ignored and must
-              be specified for each file. The maximum batch size is 2000 files. Mutually
-              exclusive with `file_ids`.
+              be specified for each file. The maximum batch size is 2000 files. This endpoint
+              is recommended for multi-file ingestion and helps reduce per-vector-store write
+              request pressure. Mutually exclusive with `file_ids`.
 
           extra_headers: Send extra headers
 

src/openai/resources/vector_stores/files.py

@@ -67,7 +67,9 @@ def create(
         Args:
           file_id: A [File](https://platform.openai.com/docs/api-reference/files) ID that the
               vector store should use. Useful for tools like `file_search` that can access
-              files.
+              files. For multi-file ingestion, we recommend
+              [`file_batches`](https://platform.openai.com/docs/api-reference/vector-stores-file-batches/createBatch)
+              to minimize per-vector-store write requests.
 
           attributes: 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
@@ -498,7 +500,9 @@ async def create(
         Args:
           file_id: A [File](https://platform.openai.com/docs/api-reference/files) ID that the
               vector store should use. Useful for tools like `file_search` that can access
-              files.
+              files. For multi-file ingestion, we recommend
+              [`file_batches`](https://platform.openai.com/docs/api-reference/vector-stores-file-batches/createBatch)
+              to minimize per-vector-store write requests.
 
           attributes: 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

src/openai/types/vector_stores/file_batch_create_params.py

@@ -33,17 +33,19 @@ class FileBatchCreateParams(TypedDict, total=False):
     A list of [File](https://platform.openai.com/docs/api-reference/files) IDs that
     the vector store should use. Useful for tools like `file_search` that can access
     files. If `attributes` or `chunking_strategy` are provided, they will be applied
-    to all files in the batch. The maximum batch size is 2000 files. Mutually
-    exclusive with `files`.
+    to all files in the batch. The maximum batch size is 2000 files. This endpoint
+    is recommended for multi-file ingestion and helps reduce per-vector-store write
+    request pressure. Mutually exclusive with `files`.
     """
 
     files: Iterable[File]
     """
     A list of objects that each include a `file_id` plus optional `attributes` or
     `chunking_strategy`. Use this when you need to override metadata for specific
     files. The global `attributes` or `chunking_strategy` will be ignored and must
-    be specified for each file. The maximum batch size is 2000 files. Mutually
-    exclusive with `file_ids`.
+    be specified for each file. The maximum batch size is 2000 files. This endpoint
+    is recommended for multi-file ingestion and helps reduce per-vector-store write
+    request pressure. Mutually exclusive with `file_ids`.
     """
 
 
@@ -52,7 +54,9 @@ class File(TypedDict, total=False):
     """
     A [File](https://platform.openai.com/docs/api-reference/files) ID that the
     vector store should use. Useful for tools like `file_search` that can access
-    files.
+    files. For multi-file ingestion, we recommend
+    [`file_batches`](https://platform.openai.com/docs/api-reference/vector-stores-file-batches/createBatch)
+    to minimize per-vector-store write requests.
     """
 
     attributes: Optional[Dict[str, Union[str, float, bool]]]

src/openai/types/vector_stores/file_create_params.py

@@ -15,7 +15,9 @@ class FileCreateParams(TypedDict, total=False):
     """
     A [File](https://platform.openai.com/docs/api-reference/files) ID that the
     vector store should use. Useful for tools like `file_search` that can access
-    files.
+    files. For multi-file ingestion, we recommend
+    [`file_batches`](https://platform.openai.com/docs/api-reference/vector-stores-file-batches/createBatch)
+    to minimize per-vector-store write requests.
     """
 
     attributes: Optional[Dict[str, Union[str, float, bool]]]