Skip to content

QA Finding tools

Tools for reading a project’s QA Findings and moving the QA ticket each one landed on: the judged steps of Agentic QA runs whose page did not show the step’s expected result. A QA Finding is not an accessibility finding, and its id (qaf_…) is not a finding id. Each id argument also accepts the finding’s base64 QaFinding global id.

Every QA Finding carries the runId (qar_…) of the run that raised it, which get_qa_run_result takes, and the status of its QA ticket. Every finding of the same step content in one journey, or of the same app crash in the project, shares one QA ticket. A new finding on a DONE QA ticket reopens it to TODO; a WONT_FIX one stays WONT_FIX. A run closes an open QA ticket to DONE when it is the second finished run in a row of the journey on one environment to pass the ticket’s step, or, for a crash, to get past it. A ticket with a finding on another environment since it last opened stays open.

List a project’s QA Findings, newest first.

NameTypeRequiredNotes
project_idstringyes
firstnumbernoHow many QA Findings to return, 1 to 100. Default 20.
afterstringnopageInfo.endCursor from the previous call, to load the next page.
statusstringnoOnly findings whose QA ticket has this status.

Returns: findings, totalCount and pageInfo (hasNextPage, endCursor). Each finding has its id (qaf_…), runId (qar_…), journeyName, stepIndex (0-based), severity, instruction and status. A project with no QA Findings returns an empty findings list. An unknown project is an error block.

Get one QA Finding.

NameTypeRequiredNotes
qa_finding_idstringyesA qaf_… id from list_qa_findings, or from qaAuditRun.findings in get_qa_run_result.

Returns: the finding’s id, runId, journeyName, locale (null when the journey named none), stepIndex, severity, instruction, status, closedByRunId (the qar_… run that closed the QA ticket, or null when no run closed it), expectedResult, observed (what the page showed instead), reasoning (why the step was judged failed), url (the page) and screenshotUrl. An id you cannot reach is an error block naming it.

Set the status of the QA ticket a QA Finding landed on.

NameTypeRequiredNotes
qa_finding_idstringyesA qaf_… id on the QA ticket to move.
statusstringyesSee the generated ticket tool reference for accepted status values.

Returns: the QA ticket’s id (qat_…) and status. An id you cannot reach is an error block.