Skip to content
Shortcut: /, ⌘K or Ctrl+K

Review recorded findings

Read the conditions BanSafe recorded on a Number, check when each was last seen, and acknowledge them.

View as Markdown

A finding records a condition BanSafe observed on a Number at a specific time, with the evidence and a suggested fix. Findings are separate from Health: they do not change the score, and a new Health estimate does not refresh or resolve them.

Before you begin#

  • To read findings through the API, use a team key or project token with sessions:read.
  • To acknowledge a finding, sign in to the Console as a team owner or admin.

Read findings#

Console

Open the project's Safety page and select a Number. Findings lists each finding with its title, what was seen, the fix and when it was last seen. A check that could not be measured shows a dash and the reason, never a green check.

API

Shell
curl "https://api.polymorfa.com/platform/bansafe/findings?projectId=$PROJECT_ID&status=open" \
  -H "Authorization: Bearer $POLYMORFA_API_KEY"

Filter by session, status or severity. One Number's findings are also in API Get ban safe health. See List findings.

Each finding carries:

FieldMeaning
keyStable identifier of the check.
titleReadable name.
summaryA sentence built from the evidence.
fixThe change that addresses it.
severitySeverity at the last update.
statusopen, acknowledged or resolved.
evidenceBounded numbers: counts, ratios and timing summaries.
firstSeenAt, lastSeenAtWhen the condition was first and last observed.
occurrences, reopenedCountHow often it was seen and reopened.

Read lastSeenAt before acting on a finding. The condition can have changed since then.

Acknowledge a finding#

Acknowledging records that a named person on your team has seen the finding. Support reads acknowledgements when reviewing an appeal, so API keys and project tokens cannot acknowledge.

  1. Open the Number on the Safety page. Under Findings, select Acknowledge on the finding.
  2. Optionally add a note of up to 500 characters.
  3. Optionally snooze the finding's notifications for 1 to 30 days.
  4. Confirm.

The row then shows who acknowledged it and when. Acknowledging an already acknowledged finding keeps the original details.

You must acknowledge every open finding on a Number before you can appeal a restriction.

What evidence contains#

Evidence is bounded counts, ratios and timing summaries. It never contains message text, media, message identifiers, recipient identifiers or chat history.

See also#