Skip to main content
List files and directories in the sandbox filesystem. 
from gravixlayer import GravixLayer

client = GravixLayer(api_key="YOUR_API_KEY")

sandbox = client.sandbox.sandboxes.create(template="python-base-v1", timeout=300)
sid = sandbox.sandbox_id

file_list = client.sandbox.sandboxes.list_files(sid, path="/home/user")
for f in file_list.files:
    kind = "[DIR] " if f.is_dir else "      "
    print(f"  {kind}{f.name}  ({f.size} bytes)")

​
Request Parameters

ParameterTypeRequiredDescription
pathstringYesDirectory path to list

​
Response

{
  "files": [
    {
      "name": "data.txt",
      "type": "file",
      "size": 1024,
      "modified": "2025-01-27T10:30:00Z"
    },
    {
      "name": "output",
      "type": "directory",
      "size": 0,
      "modified": "2025-01-27T10:25:00Z"
    }
  ],
  "path": "/home/user"
}

​
Response Fields

FieldTypeDescription
filesarrayList of files and directories
files[].namestringFile or directory name
files[].typestring”file” or “directory”
files[].sizeintegerSize in bytes (0 for directories)
files[].modifiedstringLast modified timestamp (ISO 8601)
pathstringListed directory path

​
Example: List Root Directory

file_list = client.sandbox.sandboxes.list_files(sid, path="/")
for f in file_list.files:
    kind = "[DIR] " if f.is_dir else "      "
    print(f"  {kind}{f.name}  ({f.size} bytes)")

​
Next Steps

Read File

Read file contents

Write File

Write content to files

Make Directory

Create new directories

Delete File

Delete files and directories