Move a tracked storage folder
Renames every Athena-managed file in the client selected by `X-Athena-Client` below the source prefix, invalidates cached URLs, and preserves Athena authorization state.
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/folders/move" \ -H "X-Athena-Client: string" \ -H "Content-Type: application/json" \ -d '{ "s3_id": "8af08875-1c30-4b11-b668-b572a769e623", "from_prefix": "string", "to_prefix": "string" }'{
"status": "string",
"message": "string",
"data": {
"s3_id": "string",
"prefix": "string",
"processed_files": 0
}
}