Get an authorized view URL for one file

Authorization is always checked first against the Athena client selected by `X-Athena-Client`. Athena then returns a cached or newly generated short-lived presigned GET URL.

Path Parameters

file_id*string

Query Parameters

purpose?string

Value in"read" | "download" | "stream"

Header Parameters

X-Athena-Client*string

Logical Athena client whose database stores the managed storage metadata and S3 catalog rows.

X-Athena-Auth-Session-Token?string

Preferred Athena Auth session token forwarded by the SDK for managed storage authorization.

Cookie?string

Optional cookie header. Athena Storage resolves athena-auth.session-token or athena-auth.session_token when present.

Authorization?string

Optional bearer token forwarded by trusted SDK callers. When configured, Athena mirrors bearer auth into storage session resolution.

X-User-Id?stringDeprecated

Deprecated trusted-server compatibility header. Primary Athena Storage auth resolves the actor from Athena Auth session context instead.

X-Organization-Id?stringDeprecated

Deprecated trusted-server compatibility header. Primary Athena Storage auth resolves the active organization from Athena Auth session context instead.

Response Body

`application/json`

curl -X GET "https://athena-cluster.com/storage/files/string/url" \  -H "X-Athena-Client: string"

{
  "status": "string",
  "message": "string",
  "data": {
    "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"
  }
}

Empty