Create authorized upload URLs for many files
Batch variant used for folder uploads; every file is registered in the Athena client selected by `X-Athena-Client` before its presigned PUT URL is returned.
Header Parameters
Logical Athena client whose database stores the managed storage metadata and S3 catalog rows.
Preferred Athena Auth session token forwarded by the SDK for managed storage authorization.
Optional cookie header. Athena Storage resolves athena-auth.session-token or athena-auth.session_token when present.
Optional bearer token forwarded by trusted SDK callers. When configured, Athena mirrors bearer auth into storage session resolution.
Deprecated trusted-server compatibility header. Primary Athena Storage auth resolves the actor from Athena Auth session context instead.
Deprecated trusted-server compatibility header. Primary Athena Storage auth resolves the active organization from Athena Auth session context instead.
Request Body
application/json
Response Body
application/json
curl -X POST "https://athena-cluster.com/storage/files/upload-urls" \ -H "X-Athena-Client: string" \ -H "Content-Type: application/json" \ -d '{ "files": [ { "s3_id": "8af08875-1c30-4b11-b668-b572a769e623", "storage_key": "string" } ] }'{
"status": "string",
"message": "string",
"data": {
"files": [
{
"file": {
"id": "string",
"name": "string",
"original_name": "string",
"url": "string",
"bucket": "string",
"s3_id": "8af08875-1c30-4b11-b668-b572a769e623",
"prefix_path": "string",
"size_bytes": 0,
"mime_type": "string",
"resource_id": "string",
"organization_id": "string",
"metadata": {},
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z",
"storage_key": "string",
"uploaded_by_user_id": "string",
"extension": "string",
"is_public": true,
"status": "string",
"deleted_at": "2019-08-24T14:15:22Z"
},
"upload": {
"file_id": "string",
"bucket": "string",
"storage_key": "string",
"purpose": "string",
"url": "string",
"expires_at": "2019-08-24T14:15:22Z",
"expires_at_epoch_seconds": 0,
"expires_in": 0,
"cache_hit": true,
"cache_layer": "string"
}
}
]
}
}Create an authorized upload URL for one file POST
Creates or updates the Athena-managed file row in the Athena client selected by `X-Athena-Client`, grants owner access to the uploading user, and returns a short-lived presigned PUT URL.
Set visibility for many managed files POST
Set visibility for many managed files