# writeFileText

Canonical ID: `files.writeText`.

```text
writeFileText(slot, relativePath, text)
```

Replaces file contents with UTF-8 text, at most 1 MiB. Requires an explicit write grant. Use an empty relative path for a selected existing file; a writable directory can create files within its scope. Writes truncate and sync; they are not crash-atomic backups.

Returns a Map with `ok`, `status`, `value` and `error`. Check `ok` before using `value`; denial or an unavailable host is a structured failure.

Requires Creator Pro or its technical trial for IDE/CLI run and build. Available on desktop, CLI and supported native exports; not in the public playground. Source remains editable in Learner. Generated apps have no Pliro licence check.

## Call example

See the [advanced application guide](../guides/advanced-applications.md) for declarations, explicit host permissions and complete examples. This call assumes the required permissions; `handle` means the `value` from a successful open operation.

```text
writeFileText("reports", "report.txt", "Ready")
```

[Built-ins](README.md)