Skip to content

docs(vector-stores): clarify files.delete required param in api.md#1832

Open
xodn348 wants to merge 1 commit intoopenai:masterfrom
xodn348:fix/issue-1729-vector-store-files-delete-signature
Open

docs(vector-stores): clarify files.delete required param in api.md#1832
xodn348 wants to merge 1 commit intoopenai:masterfrom
xodn348:fix/issue-1729-vector-store-files-delete-signature

Conversation

@xodn348
Copy link
Copy Markdown

@xodn348 xodn348 commented Apr 19, 2026

Summary

Fixes #1729

The api.md entry for vectorStores.files.delete used { ...params } as a placeholder, which doesn't tell callers what field is actually required. The TypeScript implementation takes FileDeleteParams where vector_store_id is the only required field.

Before:

client.vectorStores.files.delete(fileID, { ...params }) -> VectorStoreFileDeleted

After:

client.vectorStores.files.delete(fileID, { vector_store_id }) -> VectorStoreFileDeleted

This matches the actual implementation in src/resources/vector-stores/files.ts where const { vector_store_id } = params is destructured and used to build the request path.

The delete method for vectorStores.files takes a required params object
containing vector_store_id, not generic spread params. Update api.md
to explicitly show { vector_store_id } instead of { ...params } so
callers know exactly which field to provide.

Fixes openai#1729
@xodn348 xodn348 requested a review from a team as a code owner April 19, 2026 18:43
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

vectorStores.files.delete method signature does not match documentation in api.md

1 participant