Skip to main content
POST
/
filesystems
/
{filesystem_id}
/
download-url
Get Download URL
curl --request POST \
  --url https://api.example.com/filesystems/{filesystem_id}/download-url \
  --header 'Content-Type: application/json' \
  --data '
{
  "expiration_seconds": 3600
}
'
{
  "expires_at": "2023-11-07T05:31:56Z",
  "instructions": "<string>",
  "method": "<string>",
  "url": "<string>",
  "content_type": "<string>"
}
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).