List authorized files for a storage prefix
Returns the Athena-managed files stored in the Athena client selected by `X-Athena-Client` under the requested prefix that the current caller may read.
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
uuidResponse Body
application/json
curl -X POST "https://athena-cluster.com/storage/files/list" \ -H "X-Athena-Client: string" \ -H "Content-Type: application/json" \ -d '{ "s3_id": "8af08875-1c30-4b11-b668-b572a769e623", "prefix": "string" }'{
"status": "string",
"message": "string",
"data": {
"count": 0,
"files": [
{
"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"
}
]
}
}Change the Athena-level public flag for one file POST
Toggles whether Athena will treat the file stored in the client selected by `X-Athena-Client` as publicly readable while the underlying object still stays private in S3-compatible storage.
Search authorized managed files POST
Search authorized managed files