latestOpenAPI 3.1.02026-08-1951540273.3 KB

008f119d866c

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