Test Spec Tools

list_test_specs

Returns the list of test specs associated with the access token's project.

Input:

Parameter	Type	Required	Description
author	String	-	Operator name

Output: TestSpec[] (with testCaseCount field)

Copy[
  {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "projectId": "proj-abc",
    "name": "Login feature test",
    "description": null,
    "testCaseCount": 12,
    "createdAt": "2026-01-01T00:00:00.000Z",
    "updatedAt": "2026-01-01T00:00:00.000Z"
  }
]

---

get_test_spec

Input:

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

Output: TestSpec (with resolved webhook field)

---

create_test_spec

Input:

Parameter	Type	Required	Description
projectId	String	-	Project ID (defaults to the token's projectId)
name	String	✓	Spec name
description	String	-	Description
webhookId	String	-	Webhook configuration ID (must be registered in the workspace)
requiredTesterEnv	String	-	Required tester environment (free text)
requiredProductEnv	String	-	Required product environment (free text)
author	String	-	Operator name

Output: TestSpec

---

update_test_spec

Input:

Parameter	Type	Required	Description
id	String	✓	Test spec composite ID ({projectId}.{specUuid})
name	String	-	Spec name
description	String	-	Description
webhookId	String	-	Webhook configuration ID (pass null to disable webhook)
requiredTesterEnv	String	-	Required tester environment
requiredProductEnv	String	-	Required product environment
author	String	-	Operator name

Output: TestSpec

---

delete_test_spec

Deletes a test spec. Cannot be deleted while at least one report (TestReport) exists under it — delete the reports first with delete_test_report. Deleting a spec cascades to its test cases, label assignments, and images. This action cannot be undone.

Input:

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

Output:

Copy{ "success": true, "id": "550e8400-e29b-41d4-a716-446655440000" }

Error: Returns VALIDATION_ERROR with details.hasReports: true if any reports exist.