Update case

Case Token

uuid

required
Globally unique identifier for the case.

Parameters for Updating a Case

All fields are optional; omitted fields are left unchanged.
The nullable fields title, assignee, and sla_deadline can be cleared by sending null.

status

string enum
Status of a case as it progresses through the review workflow:

OPEN
The case has been created and is still collecting matching transactions
ASSIGNED
An analyst has been assigned and transaction collection has stopped
IN_REVIEW
The case is actively being investigated
ESCALATED
The case has been reviewed and requires additional oversight
RESOLVED
A determination has been made and a resolution recorded
CLOSED
The case is finalized

Allowed:
OPEN, ASSIGNED, IN_REVIEW, ESCALATED, RESOLVED, CLOSED

title

string | null
New title for the case, or null to clear it

assignee

string | null
New assignee for the case, or null to unassign

resolution

string enum
Outcome recorded when a case is resolved:

CONFIRMED_FRAUD
The reviewed activity was confirmed to be fraudulent
SUSPICIOUS_ACTIVITY
The activity is suspicious but not confirmed fraud
FALSE_POSITIVE
The activity was legitimate and the alert was a false positive
NO_ACTION_REQUIRED
No further action is required
ESCALATED_EXTERNAL
The case was escalated to an external party

Allowed:
CONFIRMED_FRAUD, SUSPICIOUS_ACTIVITY, FALSE_POSITIVE, NO_ACTION_REQUIRED, ESCALATED_EXTERNAL

resolution_notes

string
Notes describing the resolution

sla_deadline

date-time | null
New SLA deadline for the case, or null to clear it

actor_token

string
Optional client-provided identifier for the actor performing this action, recorded on the resulting activity entry.

`200 Case`

object
A transaction monitoring case.

token

uuid
required
Globally unique identifier for the case

title

string | null
required
Short, human-readable summary of the case

status

string enum
required
Status of a case as it progresses through the review workflow:

Allowed:
OPEN, ASSIGNED, IN_REVIEW, ESCALATED, RESOLVED, CLOSED

queue_token

uuid
required
Token of the queue the case belongs to

priority

string enum
required
Priority level of a case, controlling queue ordering and SLA urgency

Allowed:
LOW, MEDIUM, HIGH, CRITICAL

assignee

string | null
required
Identifier of the user the case is currently assigned to

rule_token

uuid | null
required
Token of the transaction monitoring rule that triggered the case

resolution

nullResolution Outcome
required
Outcome recorded when the case was resolved

resolution_notes

string | null
required
Free-form notes describing the resolution

sla_deadline

date-time | null
required
Deadline by which the case is expected to be resolved

Additional Fields

created

date-time
required
Date and time at which the case was created

updated

date-time
required
Date and time at which the case was last updated

resolved

date-time | null
required
Date and time at which the case was resolved

collection_stopped

date-time | null
required
Date and time at which transaction collection stopped for the case

entity

null Case Entity
required
The entity the case is associated with

pending_transactions

boolean
required
Whether the case still has transaction scopes pending resolution

`400 Bad Request`

`404 Not Found`

Example cURL Request

curl --request PATCH \
     --url https://sandbox.lithic.com/v1/transaction_monitoring/cases/case_token \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "status": "OPEN",
  "title": "string",
  "assignee": "string",
  "resolution": "CONFIRMED_FRAUD",
  "resolution_notes": "string",
  "tags": {
    "additionalProp": "string"
  },
  "priority": "LOW",
  "sla_deadline": "2026-07-18T00:25:53.489Z",
  "actor_token": "string"
}
'

Example JSON Response

{
  "token": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "title": "string",
  "status": "OPEN",
  "queue_token": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "priority": "LOW",
  "assignee": "string",
  "rule_token": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "resolution": "CONFIRMED_FRAUD",
  "resolution_notes": "string",
  "sla_deadline": "2026-07-18T00:25:53.489Z",
  "tags": {
    "additionalProp": "string"
  },
  "created": "2026-07-18T00:25:53.489Z",
  "updated": "2026-07-18T00:25:53.489Z",
  "resolved": "2026-07-18T00:25:53.489Z",
  "collection_stopped": "2026-07-18T00:25:53.489Z",
  "entity": {
    "entity_type": "CARD",
    "entity_token": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
  },
  "pending_transactions": true
}

Updated about 2 months ago