front-appeals-inbox

name	front-appeals-inbox
description	Look up whether a specific email address has submitted an account ban appeal in Warp's Front Appeals inbox. Use when given an email address (e.g. from a fraud investigation) and you need to check if that user has appealed, and retrieve the content of their appeal. Returns conversations and message bodies for downstream use by other skills. Part of the fraud-bot skill suite.

Front Appeals Inbox

Check if an email address has an appeal in Front, and retrieve the appeal content.

Auth

Requires BOT_FRONT_API_KEY env var. The Appeals inbox ID defaults to the YOUR_FRONT_INBOX_ID placeholder; override it with the FRONT_INBOX_ID env var (or the --inbox-id flag).

Usage

SKILL=.agents/skills/front-appeals-inbox/scripts/front_client.py

python3 $SKILL search-email --email [e-mail]

Returns a JSON array of {conversation, messages} objects. Each entry has:

• conversation.id — conversation ID
• conversation.subject — email subject
• conversation.status — open, archived, resolved, etc.
• conversation.created_at — Unix timestamp
• conversation.recipient.handle — the appellant's email address
• messages[].author — sender info (null for inbound emails; use conversation.recipient.handle for the appellant's email instead)
• messages[].text — plain text body
• messages[].created_at — Unix timestamp
• messages[].type — email for inbound/outbound, comment for internal notes

Messages are ordered newest-first. The original appeal email is the last message in the array.

Empty array [] means no appeals found for that email.

Setup Utility

python3 $SKILL list-inboxes  # verify inbox IDs