Update an adverse-media story verdict

PATCH

/api/v1/screening/stories/{storyId}

Set a verdict (and one rationale) on a whole adverse-media story — applies to every source hit grouped under it

Authorizations

• apiKey

Parameters

Path Parameters

storyId

required

string

Screening story ID

Request Body ^required

object

status

required

string

Allowed values: IN_REVIEW CONFIRMED DISMISSED NOT_REVIEWED TRUE_MATCH FALSE_POSITIVE

note

string

Example

Same antitrust matter across all sources — resolved to minor fines. False positive.

severity

Reviewer-overridden severity tier label for this story — applied to every member hit’s matchResult.severity, not just the primary source. Defaults per type are PEP ‘Class 1’-‘Class 4’ and Adverse Media/Sanctions/Warning ‘High’/‘Medium’/‘Low’, but tiers are workspace-configurable and renameable, so the valid set depends on the account’s taxonomy. Pass null to clear.

string

nullable

Responses

200

object

id

required

string

Example

507f1f77bcf86cd799439011

type

required

string

Allowed values: ADVERSE_MEDIA SANCTIONS WARNING PEP

headline

required

string

Example

Mexico antitrust case against seven banks closed with minor fines

summary

required

string

Example

One event tracked from a Dec 2019 collusion probe to its Jan 2021 resolution with minor fines.

aiDescription

required

One reviewer-facing AI description standing in for the per-source rationales.

string

primaryHitId

required

The primary (most credible, latest-development) source’s hit id.

string

Example

507f1f77bcf86cd799439012

memberHitIds

required

Member hit ids, ordered newest-development-first (primary leads).

Array<string>

category

Story-level category (latest state).

object

label

required

string

Example

Financial Crime

description

Concise (≤12 word) description of the risk type shown on the (i) hover

string

nullable

severity

Story-level severity tier label (latest state).

string

nullable

Example

{
  "id": "507f1f77bcf86cd799439011",
  "type": "ADVERSE_MEDIA",
  "headline": "Mexico antitrust case against seven banks closed with minor fines",
  "summary": "One event tracked from a Dec 2019 collusion probe to its Jan 2021 resolution with minor fines.",
  "aiDescription": "string",
  "primaryHitId": "507f1f77bcf86cd799439012",
  "memberHitIds": [
    "string"
  ],
  "category": {
    "label": "Financial Crime",
    "description": "string"
  },
  "severity": "string"
}