API Reference
- Introduction
- Authentication
- Headers
- Errors
- Supported Providers
- SDKs
- API Details
Chat Completions
Portkey Endpoints
Embeddings
Other APIs
Completions
Moderations
Fine-tuning
Assistants
- Assistants
- Threads
- Messages
- Runs
- Run Steps
List Files
GET
/
files
curl https://api.portkey.ai/v1/files \
-H "x-portkey-api-key: $PORTKEY_API_KEY" \
-H "x-portkey-virtual-key: $PORTKEY_PROVIDER_VIRTUAL_KEY" \
{
"data": [
{
"id": "<string>",
"bytes": 123,
"created_at": 123,
"filename": "<string>",
"object": "file",
"purpose": "assistants",
"status": "uploaded",
"status_details": "<string>"
}
],
"object": "list"
}
Query Parameters
Only return files with the given purpose.
Response
200 - application/json
OK
The File
object represents a document that has been uploaded to OpenAI.
The file identifier, which can be referenced in the API endpoints.
The size of the file, in bytes.
The Unix timestamp (in seconds) for when the file was created.
The name of the file.
The object type, which is always file
.
Available options:
file
The intended purpose of the file. Supported values are assistants
, assistants_output
, batch
, batch_output
, fine-tune
, fine-tune-results
and vision
.
Available options:
assistants
, assistants_output
, batch
, batch_output
, fine-tune
, fine-tune-results
, vision
Deprecated. The current status of the file, which can be either uploaded
, processed
, or error
.
Available options:
uploaded
, processed
, error
Deprecated. For details on why a fine-tuning training file failed validation, see the error
field on fine_tuning.job
.
Available options:
list
Was this page helpful?
curl https://api.portkey.ai/v1/files \
-H "x-portkey-api-key: $PORTKEY_API_KEY" \
-H "x-portkey-virtual-key: $PORTKEY_PROVIDER_VIRTUAL_KEY" \
{
"data": [
{
"id": "<string>",
"bytes": 123,
"created_at": 123,
"filename": "<string>",
"object": "file",
"purpose": "assistants",
"status": "uploaded",
"status_details": "<string>"
}
],
"object": "list"
}