Skip to content

get_file

GET
/v1/files/{id}
curl --request GET \
--url https://example.com/v1/files/example
id
required
string

File ID

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
}

File not found or expired