Skip to content

list_files

GET
/v1/files
curl --request GET \
--url https://example.com/v1/files

List of file metadata

Media type application/json
Array<object>

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
}
]