NOTHINGPHISHY
PATCH/partner-api/digital-risk/{externalRef}/approval-status

Update digital risk approval status

Update the approval status of a digital risk record. Valid target statuses: 1 (Approved/Create Ticket), 2 (Whitelisted), 3 (Ignored). Status 1 is terminal - once a ticket is created, the status cannot be changed. Status 0 (Pending) cannot be set as a target status.

Parameters

2 parameters
externalRefstringrequired

Digital risk external ref

bodyobjectrequired
statusintegerrequired

Target approval status: 1=Approved (create ticket), 2=Whitelisted, 3=Ignored

reasonstringoptional

Optional reason for the status change

Responses

Successful responses
200OK
responseobjectoptional
externalRefstringoptional
previousStatusintegeroptional

Previous approval status (0=Pending, 1=Approved, 2=Whitelisted, 3=Ignored)

currentStatusintegeroptional

Current approval status after update

resultstringoptional

Operation result

ticketCreatedbooleanoptional

Whether a ticket was created (only true when status=1)

Status transition rules

FromToAllowedAction
01YesCreate ticket
02YesAdd whitelist tag
03YesAdd ignored tag
21YesRemove whitelist tag and create ticket
23YesRemove whitelist tag and add ignored tag
31YesCreate ticket
32YesAdd whitelist tag
1AnyNoStatus 1 is terminal
Any0NoCannot return to pending
AnySameNoDuplicate status is rejected
NOTHINGPHISHY API REFERENCE