Skip to main content
Download a file from the sandbox filesystem.

​
Basic Request

curl -X GET "https://api.gravixlayer.com/v1/agents/sandboxes/{sandbox_id}/download?path=/home/user/output.txt" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -o output.txt

​
Query Parameters

ParameterTypeRequiredDescription
pathstringYesFile path to download

​
Response

The response is the raw file content with appropriate content-type headers.

​
Example: Download Image

curl -X GET "https://api.gravixlayer.com/v1/agents/sandboxes/{sandbox_id}/download?path=/home/user/chart.png" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -o chart.png

​
Example: Download Generated Data

curl -X GET "https://api.gravixlayer.com/v1/agents/sandboxes/{sandbox_id}/download?path=/home/user/results.csv" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -o results.csv

​
Common Download Patterns

​
Download Multiple Files

# Download all files from output directory
curl -X POST https://api.gravixlayer.com/v1/agents/sandboxes/{sandbox_id}/files/list \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"path": "/home/user/output"}' | \
  jq -r '.files[].name' | \
  while read filename; do
    curl -X GET "https://api.gravixlayer.com/v1/agents/sandboxes/{sandbox_id}/download?path=/home/user/output/$filename" \
      -H "Authorization: Bearer YOUR_API_KEY" \
      -o "$filename"
  done

​
File Types

Download any file type:
  • Generated reports: .pdf, .html
  • Data exports: .csv, .json, .xlsx
  • Visualizations: .png, .jpg, .svg
  • Code outputs: .py, .js, .txt
  • Archives: .zip, .tar.gz

​
Next Steps

List Files

Find files to download

Run Python Code

Generate files to download

Upload File

Upload files for processing

Terminate Sandbox

Clean up after downloading