# Wrong Doc for Create vector store file batch

**URL:** <https://community.openai.com/t/wrong-doc-for-create-vector-store-file-batch/1364732>\
**Category:** Documentation\
**Tags:** openai-documentation, documentation\
**Created:** [November 1, 2025, 8:03pm UTC](https://community.openai.com/t/wrong-doc-for-create-vector-store-file-batch/1364732 "2025-11-01T20:03:44Z")\
**Posts on this page:** 3\
**Page:** 1

<div class="post-metadata">

**Author:** ![olivier.cuny](https://avatars.discourse-cdn.com/v4/letter/o/b9e5f3/32.png) [@olivier.cuny](https://community.openai.com/u/olivier.cuny)\
**Post date:** [November 1, 2025, 8:03pm UTC](https://community.openai.com/t/wrong-doc-for-create-vector-store-file-batch/1364732/1 "2025-11-01T20:03:45Z")

</div>

[https://platform.openai.com/docs/api-reference/vector-stores-file-batches/createBatch?lang=python](https://platform.openai.com/docs/api-reference/vector-stores-file-batches/createBatch?lang=python)

This show a request example like:

```auto
from openai import OpenAI
client = OpenAI()

vector_store_file_batch = client.vector_stores.file_batches.create(
vector_store_id=“vs_abc123”,
files=[
{
“file_id”: “file-abc123”,
“attributes”: {“category”: “finance”},
},
{
“file_id”: “file-abc456”,
“chunking_strategy”: {
“type”: “static”,
“max_chunk_size_tokens”: 1200,
“chunk_overlap_tokens”: 200,
},
},
],
)
print(vector_store_file_batch)

```

But that is not available in latest SDK to allow to specify attributes per files as in example above. Is that documentation for upcoming version or the doc is obsolete/wrong?

---

<div class="post-metadata">

**Author:** ![\_j](https://sea2.discourse-cdn.com/openai1/user_avatar/community.openai.com/_j/32/766292_2.png) [@\_j](https://community.openai.com/u/_j)\
**Post date:** [November 1, 2025, 9:10pm UTC](https://community.openai.com/t/wrong-doc-for-create-vector-store-file-batch/1364732/2 "2025-11-01T21:10:42Z")

</div>

Status: new

Here is the path where file batches-\> create is available in the Python SDK:

> <https://github.com/openai/openai-python/blob/main/src/openai/resources/vector_stores/file_batches.py>

Following commits back through when this was renamed from beta (to break every Assistant code), the “files” parameter was not, and has not been there.

In fact, I find that it is a _new_ API addition; my copy of the OpenAPI specification retrieved on Oct 7 only has has “file\_ids”, and it is _required_ instead of _optional_ allowing the alternate input.

Your Python example from before the unsupported API reference revision:

```python
from openai import OpenAI
client = OpenAI()

vector_store_file_batch = client.vector_stores.file_batches.create(
vector_store_id="vs_abc123",
file_ids=["file-abc123", "file-abc456"]
)
print(vector_store_file_batch)

```

The benefit of the “files” array seems to be per-file attributes metadata and chunking strategy, where one might even add the file name as a key-value instead of all files being the same.

So I guess wait for the code to be patched, patch it or write it yourself to see if the parameter is actually active on the API (I’m not so invested to check), or pass it with “extra\_body” (against “file\_id” still being required).

The batches method itself I’ve found cannot work alone or autonomously, as the API has a high rate of file failure and doesn’t produce an exception report, and the 10000-file-max listing itself isn’t even a reliable guarantee currently. The feature simply generates new problem report forum topics here. So writing your own higher-level code seems appropriate anyway.

`post https://api.openai.com/v1/vector_stores/{vector_store_id}/file_batches`

---

<div class="post-metadata">

**Author:** ![olivier.cuny](https://avatars.discourse-cdn.com/v4/letter/o/b9e5f3/32.png) [@olivier.cuny](https://community.openai.com/u/olivier.cuny)\
**Post date:** [November 5, 2025, 6:29pm UTC](https://community.openai.com/t/wrong-doc-for-create-vector-store-file-batch/1364732/3 "2025-11-05T18:29:23Z")

</div>

Thanks for the feedback. Given the fact that I uncovered another major issue that is a deal breaker (Deleted filed in a vector store still show in a “in\_progress” status in file list endpoint) and that the Agents SDK file search only support OpenAI vector store, I am now leaning on migrating all our dev efforts away from OpenAI. We’ve been a heavy usage Tier 5 customer for a long time, but I am losing all confidence that what sounded promising (Agent SDK + ChatKit + Vector Store) is really just an afterthought and will become vaporware quickly. I think that OpenAI focus is on the masses and not really on developers. Very disapointing. ☹