Sign in
projects

Trigger a discovery run

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

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

Changed in 2 of the 20 revisions of this API.111

  • bf198f94879a11See the full diff
    • ▲

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

      request-property-min-length-increased

    • ●

      the goal request property's maxLength was set to 2000

      request-property-max-length-set

  • 23df7263d2c51See the full diff
    • ○

      endpoint added

      endpoint-added