# Replace text in files

`POST /v1/sandboxes/{sandbox}/files/replace`

**In this build:** Works on the simulator or a real VM.

**Scope:** `file.write`

**CLI:** `harebox file replace`

## Request: `ReplaceRequest`

| Field | Type | Notes |
|---|---|---|
| `path` (required) | `string` |  |
| `find` (required) | `string` |  |
| `replace` (required) | `string` |  |
| `regex` | `boolean` |  |
| `dry_run` | `boolean` |  |

## Response: 200

`ReplaceResult`

| Field | Type | Notes |
|---|---|---|
| `files_changed` | `integer` |  |
| `replacements` | `integer` |  |

Errors follow [one format](../errors.html).