Edit a test run

testrun.updateChanges dataCreates, updates or deletes something in your workspace.

What it does

Changes a test run of the connected workspace: name (unique in the workspace), description, build version, start / end dates, status (ACTIVE, ARCHIVED, INACTIVE) and the release it counts towards (release.readiness). Send only the fields to change. Results are recorded with testrun.record_results, not here, and the git provenance a verifier run was graded against (gitSha, branch, workingTreeClean) cannot be changed. Get the id from testrun.list. Returns {success, data: the updated run, uri}.

Ask your agent

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

  • “Rename the last run to "Checkout regression, build 512"”
  • “Link this test run to the June release”
  • “The run finished today, set its end date”

Inputs

NameTypeDescription
testRunId
required
stringId of the run (the id from testrun.list).
name
optional
stringNew name, unique in the workspace.
description
optional
string | nullNew description; null clears it.
buildVersion
optional
string | nullVersion or build label of the app under test; null clears it.
startDate
optional
string | nullISO 8601 date or date-time, e.g. "2026-11-05"; null clears it.
endDate
optional
string | nullISO 8601 date or date-time, not before the start date; null clears it.
status
optional
enumACTIVE, ARCHIVED or INACTIVE.
Allowed: ACTIVEARCHIVEDINACTIVE
releaseId
optional
string | nullRelease this run counts towards (the id from release.list); null unlinks it.

The MCP call

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

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "testrun.update",
    "arguments": {
      "testRunId": "<testRunId>"
    }
  }
}

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.