Files

Use environments files or personas files. The first argument is the owning Environment or Persona (ID, short ID or exact name). File arguments are stable UUIDs. --project selects the project; otherwise the current profile's default project is used.

smoketest environments files list Staging
smoketest environments files upload Staging ./invoice.pdf --name "Sample invoice" --description "Invoice import fixture"
smoketest environments files get Staging FILE_UUID
smoketest environments files edit Staging FILE_UUID --name "Invoice with discount"
smoketest environments files replace Staging FILE_UUID ./revised-invoice.pdf
smoketest environments files download Staging FILE_UUID --output ./downloaded.pdf
smoketest environments files delete Staging FILE_UUID --yes

smoketest personas files upload Buyer ./avatar.png
smoketest personas files list Buyer --project Checkout --json

All seven commands are available under both owner types. Upload and replace calculate SHA-256 locally, upload directly to private temporary storage, and publish only after verification. MIME type is inferred from common extensions; --mime-type overrides it. Files must be regular files of at most 25 MiB. Downloads require an explicit --output; existing destinations require --force to overwrite. Noninteractive deletion requires --yes.

Commands return JSON metadata without temporary storage URLs. Read operations require a read API scope and mutations require write, intersected with current project permissions.

Replacing preserves the file UUID. Reference that UUID in Test Markdown using [label](smoketest-file:UUID), or use the web editor's picker. See files in Tests for scope, previews and retention.