---
title: "SandboxFile"
description: "Local-first visual environment for building and running AI workflows. Build agents visually, deploy anywhere, privacy by design."
canonical: https://docs.nodetool.ai/nodes/nodetool/sandbox/sandboxfile
markdown: https://docs.nodetool.ai/nodes/nodetool/sandbox/sandboxfile.md
product: NodeTool
source: https://github.com/nodetool-ai/nodetool/blob/main/docs/nodes/nodetool/sandbox/sandboxfile.md
---

# SandboxFile

**Type:** `nodetool.sandbox.SandboxFile`

**Namespace:** `nodetool.sandbox`

## Description

Read, write, search, and replace files inside a sandbox session.
    sandbox, file, read, write, search, replace, edit

## Properties

| Property | Type | Description | Default |
|----------|------|-------------|---------|
| workspace_dir | `str` | Optional sandbox workspace directory. | `` |
| action | `enum` | File action to execute. | `read` |
| params | `dict` | Action parameters validated by the sandbox file tool. | `{}` |

## Outputs

| Output | Type | Description |
|--------|------|-------------|
| output | `dict[str, any]` |  |

## Related Nodes

Browse other nodes in the [nodetool.sandbox](./) namespace.