Stats

Review an audit finding

Admin-only. Marks the finding actioned or dismissed, or opens it again. Changes nothing about the site or the user.

patch/stats/audits/findings/{findingId}

Request

  • Base URL: https://api.nippy.host
  • URL: https://api.nippy.host/stats/audits/findings/{findingId}
  • Auth: bearer (a scheme the document does not define)

Path parameters

findingIdstring required

Finding UUID

Request body

status'open' | 'actioned' | 'dismissed' required
notestring

What was done, or why it is not a problem. Empty clears it.

Response

idstring required
reportIdstring required
subdomainstring required
siteIdstring nullable required

Null when the site was deleted after the audit.

siteStatusstring nullable required

The site status now, e.g. live or suspended.

siteSuspendedReasonstring nullable required
accountIdstring nullable required
ownerUserIdstring nullable required
ownerEmailstring nullable required

The owner’s address at publish time.

ownerBannedboolean required

The owner is banned now.

ownerEvidenceCasesnumber required

Evidence cases (ADR 0061) opened on the owner. A ban from the audit needs one when the owner has a suspected-CSAM finding.

category'csam' | 'phishing' | 'malware' | 'illegal' | 'scam' | 'spam' | 'suspicious' | 'privacy' required
confidence'high' | 'medium' | 'low' required
summarystring required
evidencestring nullable required
tier'A' | 'B' | 'C' | 'D' required

Null for findings with no tier.

recommendedAction'ban_owner' | 'suspend_site' | 'email_owner' | 'dismiss' required

Null for open findings with no recommendation.

recommendationReasonstring nullable required

Why that tier and that action.

status'open' | 'actioned' | 'dismissed' required
reviewNotestring nullable required
reviewedAtstring nullable required
reviewedByNamestring nullable required
createdAtstring required

Changes

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