generate_download_url

Generates a presigned HTTPS download URL for a workflow file referenced by a workflow:// resource URI.

Tool Identifier: generate_download_url

Parameters

Parameter	Type	Required	Description
resource_uri	string	Yes	A `workflow://` URI pointing to an upload or artifact

Output

Field	Type	Description
download_url	string	Presigned HTTPS URL for downloading the file (expires in 1 hour)
download_expires_at	string	ISO 8601 timestamp when the download URL expires
resource_uri	string	The original `workflow://` resource URI
filename	string	Filename extracted from the URI
tool_trace_id	string	Trace ID for observability
workflow_id	string	Workflow session ID

Usage

Use this tool when you need the full file content rather than a paginated sample from resources/read.

Example Request

{
  "name": "generate_download_url",
  "arguments": {
    "resource_uri": "workflow://550e8400-e29b-41d4-a716-446655440000/uploads/customers.csv"
  }
}

Example Response

{
  "download_url": "https://s3.amazonaws.com/bucket/uploads/550e.../customers.csv?X-Amz-Signature=...",
  "download_expires_at": "2025-01-15T13:00:00.000Z",
  "resource_uri": "workflow://550e8400-e29b-41d4-a716-446655440000/uploads/customers.csv",
  "filename": "customers.csv",
  "tool_trace_id": "abc123",
  "workflow_id": "550e8400-e29b-41d4-a716-446655440000"
}

Notes

The download URL expires after 1 hour
Works with both uploads and artifacts resource types
For artifacts stored in DynamoDB (workflow state), the service generates the URL from the workflow state service
Use resources/read for paginated sampling; use this tool for full file downloads