writeFileText

Canonical ID: files.writeText.

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 for declarations, explicit host permissions and complete examples. This call assumes the required permissions; handle means the value from a successful open operation.

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

Built-ins