| url | URL to test (must be publicly accessible) | yes | — |
| description | Additional test instructions for the tester | no | — |
| pr-numbers | PR numbers to find linked issues from (JSON array or comma-separated) | no | — |
| issue-numbers | Issue numbers to test directly (JSON array or comma-separated) | no | — |
| include-linked-issues | When true (default), issues referenced in a PR body (e.g. "Closes #123") are pulled into the test plan. Set false to test the pull request alone. | no | true |
| on-success-add-labels | Labels to add on test success (JSON array) | no | — |
| on-success-remove-labels | Labels to remove on test success (JSON array) | no | — |
| on-failure-add-labels | Labels to add on test failure (JSON array) | no | — |
| on-failure-remove-labels | Labels to remove on test failure (JSON array) | no | — |
| on-not-testable-add-labels | Labels to add when issue is not testable (JSON array) | no | — |
| on-not-testable-remove-labels | Labels to remove when issue is not testable (JSON array) | no | — |
| on-timeout-add-labels | Labels to add on test timeout (JSON array) | no | — |
| on-timeout-remove-labels | Labels to remove on test timeout (JSON array) | no | — |
| fail-on-error | Fail the workflow on system errors | no | true |
| fail-on-failure | Fail the workflow if any test fails. Requires a boolean "success" field in the output schema — without one, completed tests always count as passed. | no | true |
| fail-on-timeout | Fail the workflow if tester times out | no | false |
| wait-for-result | Wait for test completion before finishing. Set to false for fire-and-forget mode (creates jobs and exits immediately). | no | true |
| post-pr-comment | When true, post a PR comment containing the tester narrative, AI-extracted bug list, and a link to the full session. Each run posts a new comment so the timeline is preserved across multiple commits. Requires pr-numbers, wait-for-result=true, and a github-token with pull-requests:write. | no | false |
| api-key | Runhuman API key or PAT (rh_..., rh_pat_...) | yes | — |
| github-token | GitHub token for API access | no | ${{ github.token }} |
| template | Template name to use (resolved from .runhuman/templates/, project, or builtins) | no | — |
| template-file | Path to local template file (e.g., .runhuman/templates/smoke.md) | no | — |
| target-duration-minutes | Target test duration in minutes (1-60) | no | 5 |
| device-class | Device class: desktop or mobile | no | desktop |
| output-schema | JSON schema for extracting structured data from test results (used with description-only tests) | no | — |
| auto-create-github-issues | When set, enables (true) or disables (false) server-side auto-creation of GitHub issues from extracted QA findings using the detailed renderer (Expected / Actual / Where / Evidence / Related Telemetry). When unset, the project/template default applies. | no | — |
| auto-create-github-issues-repo | Target repo (owner/repo) for auto-created GitHub issues. Only takes effect when auto-creation is enabled via this input or the project/template. Must be one of the project's linked repos. | no | — |
| only-tester-surfaced-issues | When auto-creation is enabled and this is true, skip auto-filing issues the tester did not explicitly flag as a bug (telemetry-only findings). Defaults to false (file all extracted issues). See runhuman#3160. | no | false |
| requires-runhuman-apk-install | INTERNAL (@volter.ai callers only): request the Runhuman dual-device self-test flow, routing to testers with the APK-install capability. Non-Volter callers are rejected with 403. Distinct from generic third-party APK-install jobs. | no | false |
| enable-code-context | Preview feature. When true, bug reports include references to the specific files and symbols in your codebase that are most likely related, so issues are easier to debug. | no | false |
| commit-sha | Commit SHA the deployed app corresponds to (typically github.event.pull_request.head.sha). When provided alongside enable-code-context, code references reflect this commit's code instead of the default branch. | no | — |
| commit-base-sha | Base commit SHA the PR is merging into (typically github.event.pull_request.base.sha). When provided alongside commit-sha, code-context only re-indexes files actually changed in the PR rather than every file changed since the repo was last fully indexed. | no | — |
| wait-for-code-context | When true, the test waits up to 90 seconds for code references to be prepared for the given commit-sha before scoring. When false (default), the test proceeds immediately and code references may reflect the default branch instead of this commit. | no | false |