Skip to main content
PATCH
Record a verdict or detailed result for a case in a run

Authorizations

Authorization
string
header
required

User PAT (td_pat_) scoped to the target project

Path Parameters

projectId
string
required

The project identifier (e.g. project_abc123). Must match the project associated with your PAT.

runId
string
required
runCaseId
string
required

Per-case reference: tcm_rtc_... ID, caseKey (TC-156), or the case _id.

Body

application/json

Two mutually exclusive modes (TCM rejects mixing them): quick verdict (assigneeUserId and/or result/status/elapsed) or detailed result (comment/linkedIssues/stepResults).

assigneeUserId
string | null

User _id or email; null unassigns.

result
string

untested | passed | failed | blocked | skipped | retest (display or canonical).

status
string

Alias for result.

elapsed
number

Seconds.

Required range: x >= 0
comment
string

Rich HTML.

linkedIssues
object[]
stepResults
object[]

e.g. [{ order: 1, status: passed, comment: '' }].

Response

Per-case record updated

success
enum<boolean>
Available options:
true
data
object
pagination
object