Rename or move one Athena-managed file

Copies the object to the new key, deletes the old object, updates Athena metadata in the client selected by `X-Athena-Client`, and invalidates any cached view URLs.

Path Parameters

file_id*string

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.

Request Body

application/json

storage_key*string

bucket?|

Response Body

`application/json`

curl -X PATCH "https://athena-cluster.com/storage/files/string" \  -H "X-Athena-Client: string" \  -H "Content-Type: application/json" \  -d '{    "storage_key": "string"  }'

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

Empty