Returns a list of files that belong to the user's organization.
GET /files
GET
/files
Authorizations
Parameters
Query Parameters
purpose
string
Only return files with the given purpose.
Responses
200
OK
object
data
required
Array
The File
object represents a document that has been uploaded to OpenAI.
object
id
required
The file identifier, which can be referenced in the API endpoints.
string
bytes
required
The size of the file, in bytes.
integer
created_at
required
The Unix timestamp (in seconds) for when the file was created.
integer
filename
required
The name of the file.
string
object
required
The object type, which is always file
.
string
purpose
required
The intended purpose of the file. Supported values are assistants
, assistants_output
, batch
, batch_output
, fine-tune
, fine-tune-results
and vision
.
string
status
required
Deprecated. The current status of the file, which can be either uploaded
, processed
, or error
.
string
status_details
Deprecated. For details on why a fine-tuning training file failed validation, see the error
field on fine_tuning.job
.
string
object
required
string