Front Appeals Inbox

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 user@example.com

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