Ban Appeals

Overview

Ban Appeals is the FPH-admin detail page for a specific network ban entry and its submitted partner appeals. It shows the network ban subject, scope, status, linked report, each appeal reason, edit history, review notes, and decision controls.

This page is restricted to FPH admins.

Dashboard route

• /reports/ban-appeals?entryId=:watchlistEntryId

Inputs and controls

Input or control	What it changes	Before using it
entryId query parameter	Selects the network ban entry and appeal list.	Required; open from Bans or Cross-ban Requests.
Back to Bans	Returns to /reports/bans.	Use when the wrong entry is loaded.
Access denied state	Appears for non-FPH-admin users.	Do not route appeal decisions around this restriction.
No entry state	Appears when entryId is missing.	Navigate from an entry row.
Network ban details	Shows scope, status, and linked report.	Confirm subject and scope before deciding appeals.
View report	Opens Report Detail for the linked incident.	Use to read source evidence before deciding.
Appeal row	Shows status, submitting partner, reason, update marker, review notes, edit history, and submitted time.	Compare reason with source report and network decision.
Approve	Opens review modal with an approved decision.	Approval means the appeal succeeds and the ban should be lifted according to API behavior.
Deny	Opens review modal with a denied decision.	Use only with a clear reason.
Review notes	Optional markdown-ext notes shared with the partner.	Keep notes factual and decision-focused.
Approve - lift ban	Selects approve in the modal.	Confirm the correct appeal and entry.
Deny appeal	Selects deny in the modal.	Add review notes when denial needs explanation.
Confirm decision	Writes the selected appeal decision.	This is the audit point; do not click until reviewed.
Cancel	Closes the modal without saving.	Use if more review is needed.

Workflow

flowchart TD
  entry["Open /reports/ban-appeals?entryId"] --> access{"FPH admin?"}
  access -- No --> denied["Show access denied"]
  access -- Yes --> details["Load network ban details and appeals"]
  details --> report["Open source Report Detail"]
  report --> review["Read appeal reason and revisions"]
  review --> decision{"Decision"}
  decision -- Approve --> approve["Approve - lift ban"]
  decision -- Deny --> deny["Deny appeal"]
  approve --> notes["Add optional review notes"]
  deny --> notes
  notes --> confirm["Confirm decision"]
  confirm --> reload["Reload appeal list"]
  click report "./report-detail/" "Open Report Detail docs"

State behavior

State	What happens
Not FPH admin	Access denied alert is shown and content is hidden.
Missing entryId	No entry ID alert is shown.
No appeals	Appeals list shows No appeals submitted for this ban yet.
Pending appeal	Approve and Deny buttons are shown.
Decided appeal	Decision badge and review notes are shown; decision buttons are hidden.
Edited appeal	Updated badge and edit history appear.

Related pages

• Cross-ban Requests for network decision queue and appeal tab.
• Network Ban Appeal for partner appeal submission.
• Report Detail for source evidence.

End-to-end operator runbook

1. Confirm access and entry: Verify FPH-admin access and the loaded network ban subject.
2. Read source report: Open the linked report before deciding.
3. Review appeal text: Check reason, revisions, submitting partner, and prior review notes.
4. Decide: Choose approve or deny and add concise notes.
5. Verify reload: Confirm the appeal row shows the final status and notes.

Common mistakes

Do not decide an appeal from the appeal reason alone. The source report and network-ban scope must be reviewed before approval or denial.