Test Case Tools

list_test_cases_by_spec

Input:

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

Output: TestCase[] (ordered by index ascending)

---

list_test_cases

Returns all test cases in the project associated with the access token.

Input:

Parameter	Type	Required	Description
author	String	-	Operator name

Output: TestCase[]

---

get_test_case

Input:

Parameter	Type	Required	Description
specId	String	✓	Test spec composite ID ({projectId}.{specUuid})
caseNumber	Integer	✓	Stable case ID (the N in "case-N" shown in the UI)
author	String	-	Operator name

Output: TestCase

---

create_test_case

Created test cases are automatically assigned a caseNumber (stable ID). The caseNumber increases monotonically within the spec and does not change when other cases are deleted.

Input:

Parameter	Type	Required	Description
specId	String	✓	Test spec composite ID ({projectId}.{specUuid})
testSubject	String	✓	Test subject
steps	String[]	✓	Test steps (array of strings)
expectedResult	String	✓	Expected result
labelIds	String[]	-	Label ID array to assign (defaults to empty array)
preconditions	String	-	Preconditions
notes	String	-	Notes
author	String	-	Operator name

Output: TestCase

---

batch_create_test_cases

Creates multiple test cases in bulk (appended to the end). Optimized for AI agents generating test specs in one shot.

Constraints:

• Maximum 1000 items per request
• Error if the total request payload exceeds 6 MB
• insertAtIndex is not supported (always appends to the end)

Input:

Parameter	Type	Required	Description
specId	String	✓	Test spec composite ID ({projectId}.{specUuid})
cases	Array	✓	Array of test cases to create (1–1000 items)
cases[].testSubject	String	✓	Test subject
cases[].steps	String[]	✓	Test steps (array of strings)
cases[].expectedResult	String	✓	Expected result
cases[].labelIds	String[]	-	Label ID array to assign
cases[].preconditions	String	-	Preconditions
cases[].notes	String	-	Notes
author	String	-	Operator name

Output:

Copy{
  "created": 3,
  "testCases": [
    {
      "id": "uuid",
      "specId": "spec-uuid",
      "caseNumber": 1,
      "testSubject": "User can log in",
      "steps": ["Enter email address", "Enter password", "Click login button"],
      "expectedResult": "Redirected to dashboard",
      "labels": [],
      "preconditions": null,
      "notes": null,
      "createdAt": "2026-01-01T00:00:00.000Z",
      "updatedAt": "2026-01-01T00:00:00.000Z"
    }
  ]
}

---

update_test_case

Identifies the target by caseNumber (the stable ID corresponding to "case-N" in the UI). Only specified fields are updated. labelIds is a full-replacement (omitting it leaves labels unchanged).

Input:

Parameter	Type	Required	Description
specId	String	✓	Test spec composite ID ({projectId}.{specUuid})
caseNumber	Integer	✓	Stable case ID
testSubject	String	-	Test subject
steps	String[]	-	Test steps
expectedResult	String	-	Expected result
labelIds	String[]	-	Label ID array (full-replacement; omit to leave unchanged)
preconditions	String	-	Preconditions
notes	String	-	Notes
author	String	-	Operator name

Output: TestCase