upload_file
POST
/v1/files
const url = 'https://example.com/v1/files';const options = {method: 'POST'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://example.com/v1/filesRequest Body
Section titled “Request Body ” Media type multipart/form-data
Responses
Section titled “ Responses ”Uploaded file metadata
Media type application/json
OpenAI file metadata + mistral.rs extensions (format, mime_type, source, truncated).
object
bytes
required
integer format: int64
created_at
required
integer format: int64
filename
required
string
format
string | null
id
required
string
mime_type
required
string
object
required
string
purpose
required
string
source
required
Which agentic tool produced the file, and when in the session.
object
round
required
integer
tool
required
string
turn
required
integer
truncated
boolean
Example generated
{ "bytes": 1, "created_at": 1, "filename": "example", "format": "example", "id": "example", "mime_type": "example", "object": "example", "purpose": "example", "source": { "round": 1, "tool": "example", "turn": 1 }, "truncated": true}Invalid upload