API ReferenceOpen AI Batch

Upload a file

Upload a file to the upstream OpenAI Files API. Batch jobs use JSONL files with purpose=batch.

Headers

AuthorizationstringRequired

Bearer token. Use Bearer YOUR_API_KEY for API key auth.

Request

This endpoint expects a multipart form containing a file.
filefileRequired
File to upload.
purposestringRequired
File purpose.

Response

Uploaded file.
idstring
File ID.
objectstring
bytesinteger
File size in bytes.
created_atinteger
Unix timestamp.
filenamestring
purposestring
statusstring
File status.
status_detailsany or null
Provider status details, when available.

Errors

400
Bad Request Error
401
Unauthorized Error