Review recorded findings
Read the conditions BanSafe recorded on a Number, check when each was last seen, and acknowledge them.
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
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:
| Field | Meaning |
|---|---|
key | Stable identifier of the check. |
title | Readable name. |
summary | A sentence built from the evidence. |
fix | The change that addresses it. |
severity | Severity at the last update. |
status | open, acknowledged or resolved. |
evidence | Bounded numbers: counts, ratios and timing summaries. |
firstSeenAt, lastSeenAt | When the condition was first and last observed. |
occurrences, reopenedCount | How 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.
- Open the Number on the Safety page. Under Findings, select Acknowledge on the finding.
- Optionally add a note of up to 500 characters.
- Optionally snooze the finding's notifications for 1 to 30 days.
- 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.