Apphaven

People who signed up to the app (per environment), with their roles.

list_users

Runs of the app's automations (config docs, "Runs"), newest first: status (running; done; stopped, a run that ended at its own if/stop step, which is a normal ending; failed, with the reason in words), what started each, and for a run that isn't done, each step's state. Filter by automation or status. Automations start on changes made through the app and its sign-up, not on the data tools. Check here after run_automation, after a change that should start one, and when the owner says one failed.

list_runs

Tests the preview in a fresh browser: screenshot, console errors, failed requests and visible text. Pages and steps can change/delete data, upload files, send mail or contact external services. 'as' creates/signs in a confirmed test user; omit it for ordinary sign-up/sign-in (get_docs "sdk"). Cookies don't carry between calls. Confirm boxes are answered OK unless dialogs is dismiss. Check phone, tablet and desktop after deploy_preview.

view_page

Reads records as the app owner (access rules don't apply). Use to check what the app stored; one record by id is filter: id == <id>. Files show as name, size and state.

query_data

Docs for building on apphaven. Topics: overview (workflow, start here), config (YAML for models, access rules, operations, auth), sdk (frontend client + REST API), files (what app users upload), examples (complete apps).

get_docs

Without id: app emails, newest first, with status: captured (kept here, not delivered), sent, suppressed (bounced/unsubscribed), limited or failed. In preview only mail to the owner's Apphaven address is delivered; the rest is captured. With id: recipients, status, rendered text and HTML, including confirmation/reset/sign-in links. Use after triggering sign-in mail or an operation with email:. Check the actual status, even for the owner.

read_emails

Without path: every file in the app's workspace on Apphaven (what deploy_preview publishes), with image sizes; files the user added from the dashboard are marked. With path: that one file (binary files come back base64).

read_files

Replaces the preview database, including its accounts and records, with a fresh copy of production and reapplies the preview schema. Discards preview-only data. Production is unchanged; copied accounts have no passwords, so use test users or new sign-ups.

reset_preview_data

Replaces the workspace files with those of a past deploy (a restorable one from app_status). Data isn't touched. Deploy afterwards to put it in preview.

restore_version

Runs the entire predefined preview suite: record isolation (owner CRUD, other-user and anonymous denial) and ownership integrity (forged creator and reassignment). For private creator-owned models only. Uses deployed rules and temporary default-role users/records in a transaction that always rolls back. Returns per-check evidence. No scripts, routes or selectable operations; no emails or file uploads. Does not test UI, HTTP, sign-in or configured operations: exercise those with view_page.

run_tests

Sends feedback to the Apphaven team about blockers, bugs, unclear docs, ideas or successes. Optional; shared outside the owner's workspace and cannot be recalled here. No personal details or app data. No reply in the chat.

send_feedback

Changes existing app accounts to a configured role, e.g. admin. They must already have signed up in that environment. Can grant or revoke access. Updates one address at a time; failures report accounts already changed. People may need to sign out and in again.

set_user_role

Overwrites supplied fields of one record as the app owner, bypassing end-user access rules; readonly fields may be set. Keeps its id and links. Production changes require confirm: true, only when the user requested these changes. Does not run configured operations or emails.

update_record

Checks the apphaven/*.yaml config (with file:line errors and hints) and shows what deploy_preview would change in the database. Doesn't deploy.

validate

Creates/replaces workspace files and removes paths in delete (deletes first). Send many files at once. Changes reach the private test version after deploy_preview. restore_version recovers files from a saved deployment.

write_files