Risk

Resolve a risk flag

Closes the flag as resolved (acted on) or dismissed (false alarm). The note is required: it is the audit trail for why a fraud signal was waved through or acted on, and the change lands in the audit log naming your API key.

Scope: write

post/v1/risk_flags/{id}/resolve

Request

  • Base URL: https://api.affiliaterail.com
  • URL: https://api.affiliaterail.com/v1/risk_flags/{id}/resolve
  • Auth: HTTP bearer

Path parameters

idstring required

Request body

status'resolved' | 'dismissed'

dismissed closes it as a false alarm

notestring required

What you found; required, and written to the audit log

Response

The closed flag

idstring required

Prefixed id (rsk_…)

object'risk_flag' required
kindstring required
severity'high' | 'medium' | 'low' required
status'open' | 'reviewing' | 'resolved' | 'dismissed' required
evidenceobject required

What the check saw: rates, ids, windows

resolved_atstring date-time nullable required

ISO-8601, UTC

resolved_bystring nullable required
resolution_notestring nullable required
created_atstring date-time required

ISO-8601, UTC

Example response

{
  "id": "rsk_7uSyy9FqVLCFWrdPeZaK",
  "partner": {
    "id": "part_7uSyy9FqVLCFWrdPeZaK"
  },
  "customer": {
    "id": "cus_7uSyy9FqVLCFWrdPeZaK"
  },
  "resolved_at": "2026-08-21T10:15:30.000Z",
  "created_at": "2026-08-21T10:15:30.000Z"
}

Changes

No recorded changes to this operation across all 1 revision of this API.