API / Endpoints
Files
Upload, list, retrieve, and delete files through the OpenAI-format endpoint.
Browse docs
Overview
File endpoints let you upload and manage files used for batch processing, fine-tuning, and other provider-native workflows. Files are stored by the upstream provider — Aurora proxies the requests through its routing pipeline.
Upload a File
POST /v1/files
text
curl http://your-aurora-host/v1/files \
-H "Authorization: Bearer $AURORA_MASTER_KEY" \
-F "file=@data.jsonl" \
-F "purpose=batch"
Parameters:
Response:
text
{
"id": "file-abc123",
"object": "file",
"bytes": 12345,
"created_at": 1728000000,
"filename": "data.jsonl",
"purpose": "batch"
}
List Files
GET /v1/files
text
curl http://your-aurora-host/v1/files \
-H "Authorization: Bearer $AURORA_MASTER_KEY"
Get File
GET /v1/files/{id}
text
curl http://your-aurora-host/v1/files/file-abc123 \
-H "Authorization: Bearer $AURORA_MASTER_KEY"
Delete File
DELETE /v1/files/{id}
text
curl -X DELETE http://your-aurora-host/v1/files/file-abc123 \
-H "Authorization: Bearer $AURORA_MASTER_KEY"
Download File Content
GET /v1/files/{id}/content
text
curl http://your-aurora-host/v1/files/file-abc123/content \
-H "Authorization: Bearer $AURORA_MASTER_KEY"
Returns the raw file content with the appropriate Content-Type header.