PATCH
/partner-api/digital-risk/{externalRef}/approval-statusUpdate 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 parametersexternalRefstringrequiredDigital risk external ref
bodyobjectrequiredstatusintegerrequiredTarget approval status: 1=Approved (create ticket), 2=Whitelisted, 3=Ignored
reasonstringoptionalOptional reason for the status change
Responses
Successful responses200OK
responseobjectoptionalexternalRefstringoptionalpreviousStatusintegeroptionalPrevious approval status (0=Pending, 1=Approved, 2=Whitelisted, 3=Ignored)
currentStatusintegeroptionalCurrent approval status after update
resultstringoptionalOperation result
ticketCreatedbooleanoptionalWhether a ticket was created (only true when status=1)
Status transition rules
| From | To | Allowed | Action |
|---|---|---|---|
| 0 | 1 | Yes | Create ticket |
| 0 | 2 | Yes | Add whitelist tag |
| 0 | 3 | Yes | Add ignored tag |
| 2 | 1 | Yes | Remove whitelist tag and create ticket |
| 2 | 3 | Yes | Remove whitelist tag and add ignored tag |
| 3 | 1 | Yes | Create ticket |
| 3 | 2 | Yes | Add whitelist tag |
| 1 | Any | No | Status 1 is terminal |
| Any | 0 | No | Cannot return to pending |
| Any | Same | No | Duplicate status is rejected |
NOTHINGPHISHY API REFERENCE
