Delete several test cases

case.delete_batchChanges dataCreates, updates or deletes something in your workspace.

What it does

Permanently deletes up to 200 test cases in one call. This cannot be undone. Same rules as case.delete for each id: a case that was ever part of a test run, or is filed under a feature or suite, is refused (archive those with case.update and status INACTIVE instead), and ids from another workspace are refused. One failure does not stop the rest. Returns { success, message, deleted, failed, results: [{ id, success, message? }] }; success is true only when every id was deleted. Confirm the list with the user before calling.

Ask your agent

You don’t call case.delete_batch yourself. Say something like this to Claude Code, Cursor or another MCP-connected agent:

  • “Clean up all the duplicate test cases you created”
  • “Delete these five draft tests”
  • “Remove every test case for the feature we dropped”

Inputs

NameTypeDescription
caseIds
required
string[]Internal test case ids to delete, 1 to 200: the id values from case.list, e.g. ["AAtc-kzqd-mwpe-rtya-hbnc-xufo-lgsi"], not human caseIds like "GenTC-0001".

The MCP call

What the agent’s MCP client sends (placeholders in angle brackets):

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "case.delete_batch",
    "arguments": {
      "caseIds": [
        "<caseId>"
      ]
    }
  }
}

Connect your agent

npx -y @testmaze/mcp init tmt_xxx
claude mcp add tm --scope project -- npx -y @testmaze/mcp

Create the token in your Test Maze workspace under Settings → MCP. Setup for Cursor, Cline, Gemini CLI and Codex CLI is shown there too.