Upload files

Upload files to QA Wolf and use them in your test flows.

QA Wolf accepts file uploads via a two-step signed URL process. See v0/run-inputs-executables-signed-urls.

Make sure you have:

• Your QAWOLF_API_KEY — available under Workspace Name → Workspace Settings → Integrations → API Access

Use an uploaded file in a flow

Mobile apps

Reference the uploaded file using the RUN_INPUT_PATH environment variable, which is set automatically when a file is uploaded via the API.

const APK_PATH = `/home/wolf/run-inputs-executables/${process.env.RUN_INPUT_PATH || "default-file.apk"}`;

const driver = await wdio.startAndroid({
  "appium:app": APK_PATH,
});

Web file upload

Use Playwright’s filechooser event to intercept the file dialog and set the uploaded file programmatically.

const fileName = `${process.env.TEAM_STORAGE_DIR}/fileNameHere`;

page.once(
  "filechooser",
  (chooser) => void chooser.setFiles(fileName).catch(console.error)
);

await page.getByText("Upload file").click();

Use page.once rather than page.on. page.once registers a one-time event listener that automatically unregisters after the first use. Using page.on adds a persistent listener that may interfere with subsequent file uploads in the same flow.

PDF viewing

Use the internal PDF viewer to open an uploaded PDF file in a flow.

const invoicePath = `${process.env.TEAM_STORAGE_DIR}/invoices/invoice-1.pdf`;

const pdfPage = await context.newPage();
await pdfPage.goto("http://pdf-viewer.psc.qaw.internal");

pdfPage.once(
  "filechooser",
  (chooser) => void chooser.setFiles(invoicePath).catch(console.error)
);

await pdfPage.waitForTimeout(4000);
await pdfPage.click("#openFile");

Supported file types

Mobile apps (.apk, .aab, .ipa)

Use a static filename based on the environment (e.g., app-staging.ipa) so tests always reference the latest build. See Mobile build testing for how to automate this as part of your build process.

ZIP archives (.zip)

ZIP files can be used to bundle multiple assets for a single upload. Ensure the contents follow any structure expected by the tests that will consume them.

CSV files (.csv)

CSV files are typically used as test data inputs. Use a consistent filename so flows always pick up the latest version.

PDF files (.pdf)

PDF files can be uploaded for use in test flows that involve document handling or validation.