molted overrides

molted overrides counts
# → {
#     "needs_approval_outbound": 5,   # held thread with an outbound message (e.g. a send awaiting OK)
#     "needs_approval_inbound":  2,   # held thread with only inbound mail
#     "blocked_by_policy":       0,   # policy engine blocked a send or an inbound message
#     "high_risk":               1,   # thread anomaly or adversarial routing
#     "spam":                    3    # reported as spam (report-spam)
#   }
# Counts cover unresolved threads in mailboxes the key can manage.
# Spam the classifier flagged sits in needs_approval, not in spam.

# Drill into a queue. Valid queue names (distinct from count fields):
#   needs_approval, blocked_by_policy, high_risk, spam
# The two needs_approval_* counts above BOTH surface under the single
# "needs_approval" queue -- use --direction inbound|outbound to filter.
molted overrides queue needs_approval --limit 10
molted overrides queue blocked_by_policy
molted overrides queue high_risk
molted overrides queue spam

molted overrides held-messages --thread-id <id>
# → messages held for a specific thread

molted overrides approve <threadId>
# → prints the link for a human to approve the pending send

molted overrides release <messageId>
# → prints the link for a human to release the held message

molted overrides reject-held <messageId>
# → prints the link for a human to reject the held message
#   (alias: molted overrides reject <messageId>)

molted overrides edit <threadId>
# → prints the link for a human to edit and redirect

molted overrides reject-send <threadId> --reason "Wrong template"
# → { "threadId": "...", "status": "resolved", "auditEventId": "...",
#     "rejectedApprovalIds": [...] }
#   Rejects every pending send approval on the thread and moves the
#   thread to the trash. Only while the human gate is off or in warn:
#   once it enforces, 403 human_decision_required with a decisionUrl,
#   your own send included. 400 if the thread is in no review queue.

molted overrides escalate <threadId> --reason "Complex legal question" \
  --assign-to "legal-team"

molted overrides not-spam <threadId> --reason "Legitimate sender"
# → clears a thread from the spam queue, OR from needs_approval when the
#   classifier itself put it there with a safety verdict (any other
#   thread is refused 400). Ungated ONLY for a thread currently in the spam queue that the
#   classifier never held (a plain inbox thread a human or agent manually
#   reported as spam). Everything else -- needs_approval, high_risk,
#   blocked_by_policy, or ANY safety verdict at all, including one that
#   reads "spam" -- is gated like a human decision: 403
#   human_decision_required with a decisionUrl, same as approve/edit/
#   release above. (A thread's safety_verdict reflects only the latest
#   classified message on it, so it can't be trusted to tell a corrected
#   false positive apart from a still-dangerous thread -- an earlier
#   phishing message followed by a later spam-only one flips the whole
#   thread's verdict to "spam".) A phishing/malware/abuse/impersonation
#   verdict is refused 409 quarantine_verdict (no decisionUrl): only a
#   release from Quarantine lets it through. Also refused (403) on a
#   thread a human has taken over, regardless of verdict. Records spam feedback on
#   success so the sender's reputation improves; after 3+ HUMAN not-spam
#   marks for the same address it's auto-added to the sender allow-list
#   (never as a whole domain).

molted overrides report-spam <threadId>
# → moves a thread into the spam queue and records spam feedback. Refused
#   (400) when the thread is already needs_approval/high_risk/
#   blocked_by_policy -- use approve/reject/escalate for those instead.
#   Refused (409) on a thread in the trash, (403) on a taken-over thread.

molted overrides delete-spam <threadId>
# → resolves + trashes a thread in the spam queue (confirms spam) and
#   records spam feedback. Refused (403) on a taken-over thread.
#   Also takes a classifier-flagged spam thread (needs_approval with a
#   "spam" verdict), but that is gated like reject: 403
#   human_decision_required with a decisionUrl once the gate enforces,
#   and 409 while the thread has a pending send approval. Any other
#   thread is refused 400.

molted overrides spam-stats
# → { total, spamReports, notSpamReports, uniqueDomains }

molted overrides sender-reputation --domain example.com
# → per-sender rows: spamCount, notSpamCount, authPassCount, ...

molted overrides correct-label <messageId> none
# → says the message's platformLabel was wrong: none (not any label, e.g.
#   "not an opt-out"), opt_out, auto_reply or delivery_notice. Feedback
#   only: helps Molted learn to sort mail, and changes no routing, no
#   suppression and not the platformLabel anyone reads. Act yourself: for
#   a real opt-out add a suppression (molted suppressions add). A "none"
#   never removes a suppression; removing one is a person's decision.

molted overrides alerts
# → { checkedAt, overallLevel, conditions: [{ name, value, level,
#     description }] }: queue staleness and age, send failures, policy
#     blocks, bounce rate, complaints and SLA breaches, each rated
#     ok, warning or critical

molted overrides counts

molted overrides queue [options] <queue>

molted overrides held-messages [options]

molted overrides release <messageId>

molted overrides reject-held <messageId>

molted overrides approve <threadId>

molted overrides reject-send [options] <threadId>

molted overrides edit <threadId>

molted overrides escalate [options] <threadId>

molted overrides not-spam [options] <threadId>

molted overrides correct-label <messageId> <label>

molted overrides report-spam <threadId>

molted overrides delete-spam <threadId>

molted overrides spam-stats

molted overrides sender-reputation [options]

molted overrides alerts