projects

Trigger a discovery run

Changed on

Queue a free-roam discovery run: the QA agent gets only a goal, decides what to test itself, and reports every bug it finds. Supports web, iOS, and Android; mobile platforms explore the uploaded app. FAILED means bugs were found.

post/v1/projects/{projectId}/discovery-runs

Request

  • Base URL
    https://tester.army/api
  • Auth
    none declared. Required headers: Authorization

Path parameters

projectIdstring required

Project ID or shortId

Headers

Authorizationstring required

API key authentication using Bearer token format

Request body

goalstring required

The exploration goal for the free-roam QA agent, e.g. "Explore the checkout flow and find bugs". The agent decides what to test; there is no predefined step list.

targetUrlstring uri

Optional URL to explore instead of the project's production URL. Web only.

platform'web' | 'ios' | 'android'

Target platform; defaults to web. Mobile platforms explore the uploaded app.

appIdstring

Uploaded mobile app ID to explore. Defaults to the project's latest app for the platform.

deviceModel'iphone' | 'ipad'

Mobile device variant within the platform (e.g. ipad on iOS). Omit for the default phone-sized device.

Response

Discovery run queued successfully

status'queued' required
runIdstring uuid required
projectIdstring uuid required
platform'web' | 'ios' | 'android' required

Changes

    • info

      api operation id trigger-a-discovery-run removed and replaced with projects_triggerADiscoveryRun

    • breaking

      the request property's minLength was increased from 0 to 8

    • warning

      the request property's maxLength was set to 2000