Skip to main content
POST
Get Download URL
This endpoint returns a presigned URL for downloading the entire filesystem archive directly from storage. Use it when you want a storage-backed archive download, not when you want one file by relative path.

What This Endpoint Is For

  • whole-filesystem download
  • direct-from-storage archive transfer
  • flows implemented by tu fs pull and the Python ADK sync internals

What This Endpoint Is Not For

  • downloading one file by relative path
  • replacing downloadFile or download_file
  • a dedicated CLI command
For one-file downloads, use Single-File Download. For a higher-level CLI experience, use tu fs pull.

Path Parameters

filesystem_id
string
required

Body

application/json

Request model for presigned URL generation.

expiration_seconds
integer
default:3600

URL expiration time in seconds (default 1 hour, max 7 days).

Required range: 60 <= x <= 604800

Response

Successful Response

Response model for presigned URL operations.

expires_at
string<date-time>
required

When the presigned URL expires.

instructions
string
required

Instructions for using the presigned URL.

method
string
required

HTTP method to use: 'PUT' for upload, 'GET' for download.

url
string
required

The presigned URL for direct GCS upload/download.

content_type
string | null

Content-Type header to use (required for PUT uploads).