Test Report Tools

start_test

Starts test execution from a test spec and creates a new report (TestReport). TestReportResult entries are automatically generated for all test cases in the spec.

Input:

Parameter	Type	Required	Description
specId	String	✓	Test spec composite ID ({projectId}.{specUuid})
reportName	String	✓	Report name
webhookEnabled	Boolean	-	Enable webhook (defaults to the spec's setting)
author	String	-	Operator name

Output: TestReport (without reportResults)

---

list_test_reports

Returns the list of reports in the project associated with the access token.

Input:

Parameter	Type	Required	Description
author	String	-	Operator name

Output: TestReport[] (without reportResults)

---

get_test_report

Input:

Parameter	Type	Required	Description
id	String	✓	Test report composite ID ({projectId}.{specUuid}.{reportUuid})
author	String	-	Operator name

Output: TestReport (with reportResults field)

---

update_test_report_result

Updates a single test result.

Processing: When a queue is configured, processed asynchronously via SQS (equivalent to 202). For local development (no queue), processed synchronously (backwards compatible).

Input:

Parameter	Type	Required	Description
reportId	String	✓	Test report composite ID ({projectId}.{specUuid}.{reportUuid})
resultId	String (UUID)	✓	Test result ID
testResult	String	-	OK / NG / SKIP
notes	String	-	Notes
executionResultLink	String	-	Link to execution result
author	String	-	Operator name

Output (with queue):

Copy{
  "queued": true,
  "messageId": "sqs-message-id-xxxx"
}

Output (local development, no queue): TestReportResult

---

batch_update_test_results

Synchronously updates multiple test results in bulk. Optimized for recording large numbers of test results from a CI/CD pipeline.

Constraint: Maximum 100 items per request

Input:

Parameter	Type	Required	Description
reportId	String	✓	Test report composite ID ({projectId}.{specUuid}.{reportUuid})
items	Array	✓	Update list (1–100 items)
items[].resultId	String (UUID)	✓	Test result ID
items[].testResult	String	-	OK / NG / SKIP
items[].notes	String	-	Notes
items[].executionResultLink	String	-	Link to execution result
author	String	-	Operator name

Output:

Copy{
  "reportId": "report-uuid",
  "updated": 3
}

---

abort_test_report

Transitions the report to ABORTED status.

Input:

Parameter	Type	Required	Description
reportId	String	✓	Test report composite ID ({projectId}.{specUuid}.{reportUuid})
author	String	-	Operator name

Output: TestReport (status: "ABORTED")

---

reopen_test_report

Transitions an ABORTED report back to IN_PROGRESS.

Input:

Parameter	Type	Required	Description
reportId	String	✓	Test report composite ID ({projectId}.{specUuid}.{reportUuid})
author	String	-	Operator name

Output: TestReport (status: "IN_PROGRESS")

---

force_complete_test_report

Force-transitions the report to COMPLETED status. Any incomplete results (testResult: null) are automatically set to SKIP.

Input:

Parameter	Type	Required	Description
reportId	String	✓	Test report composite ID ({projectId}.{specUuid}.{reportUuid})
author	String	-	Operator name

Output:

Copy{
  "report": { },
  "autoSkippedCount": 5
}

The report field contains a TestReport object with status: "COMPLETED".

---

get_completion_summary

Returns the completion rate summary for all reports in the project associated with the access token.

Input:

Parameter	Type	Required	Description
author	String	-	Operator name

Output:

Copy{
  "totalReports": 10,
  "notStartedReports": 1,
  "inProgressReports": 3,
  "completedReports": 5,
  "abortedReports": 1,
  "averageCompletionRate": 0.75
}