CreateFileRequest does not include "vision" purpose

[phronmophobic]

Use "assistants" for Assistants and Message files, "vision" for Assistants image file inputs,

The purpose documentation says "vision" is a valid purpose, but the spec does not include it:

openai-openapi/openapi.yaml

Line 8603 in 893ba52

enum: ["assistants", "batch", "fine-tune"]

[dewmguy]

https://platform.openai.com/docs/api-reference/files/create

documentation clearly states

"vision" for Assistants image file inputs

https://platform.openai.com/docs/api-reference/files/object#files/object-purpose

documentation also states vision is an appropriate use for the 'purpose' enum.

i'm under the assumption that my code (snippet below) should be working when using the vision purpose

const isImage = file.name.match(/\.(jpeg|jpg|webp|png)$/i);
const filePurpose = isImage ? 'vision' : 'assistants';
const fileData = await openai.files.create({ file: fileObject, purpose: filePurpose });

but i get this error:

Error: 400 Files with extensions [.png] are not supported for retrieval. See https://platform.openai.com/docs/assistants/tools/file-search/supported-files.

should i be using urls rather than trying to push the file buffer like i would for any other file upload purpose?