v0/run-inputs-executables-signed-urls

GET https://app.qawolf.com/api/v0/run-inputs-executables-signed-urls

If your build server supports node, use @qawolf/ci-sdk instead of calling this endpoint directly.

This endpoint accepts app builds only: .aab, .apk, .appimage, .deb, .exe, .ipa, .msi, .rpm, and .zip. A file your flows read, such as a .csv or .pdf, returns a 400. Upload it to team storage instead.

Generate a signed URL

curl "https://app.qawolf.com/api/v0/run-inputs-executables-signed-urls?file=$DESTINATION_FILE_PATH" \
  -H "Authorization: Bearer $QAWOLF_API_KEY"

Returns a signedUrl for the next step, plus fileLocation and interactiveRunFileLocation — see below for the full parameter and response reference.

Upload the file

PUT {signedUrl}The previous request returns the signed URL. It is not a fixed /api/ endpoint — it points directly to Google Cloud Storage.

curl -X PUT \
  --header "Content-Type: application/octet-stream" \
  --data-binary @some_file.zip \
  $SIGNED_URL

Query parameters

Parameter	Description
`file`	Destination file path. At minimum the filename and extension. May include directories.
`workspaceId`	Workspace to upload to. Required with an organization or user API key. Ignored by a workspace API key, which already implies its workspace. See which workspace a request acts on.

Response

{
  "fileLocation": "$WORKSPACE_ID/$DESTINATION_FILE_PATH",
  "interactiveRunFileLocation": "$DESTINATION_FILE_PATH",
  "playgroundFileLocation": "$DESTINATION_FILE_PATH",
  "signedUrl": "https://..."
}

Field	Description
`fileLocation`	Full path including the workspace id. Use this to reference the file in run configurations.
`interactiveRunFileLocation`	Path without the workspace id. Pass it to the run as an environment variable, and use it to reference the file in an interactive run.
`playgroundFileLocation`	Deprecated alias of `interactiveRunFileLocation`. Removed in a future major version.
`signedUrl`	Pre-signed URL for uploading the file. Use in the next step.

Response codes

Code	Description
`200`	Success.
`400`	`file` is missing, or its extension isn’t one this endpoint accepts. Also returned when an organization or user API key omits `workspaceId`.

Plus the common response codes.

Mobile build testing
Testing Windows desktop apps
@qawolf/ci-sdk
Webhook — reporting the deploy that starts the runs.

Flow conventions

@qawolf/flows

@qawolf/pom

@qawolf/testkit

@qawolf/emails

@qawolf/cli

Local execution

@qawolf/ci-sdk

Triggers

REST

v0/run-inputs-executables-signed-urls

Query parameters

Response

Response codes

​Query parameters

​Response

​Response codes

​Related

Query parameters

Response

Response codes

Related