Triage actions

Proposes reporting one message as spam and returns a pending report for the person to approve. Moves nothing itself.

Inputs

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "propose_mark_spam",
    "arguments": {
      "inboxId": "inbox_lx2k9a1b",
      "messageId": "18f3a2b4c5d6e7f8"
    }
  }
}

Moves the proposed message to Spam or Junk after the person approves. One-shot, ~15 min expiry.

Inputs

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "confirm_mark_spam",
    "arguments": {
      "pendingSpamId": "...",
      "approvalCode": "K7Q2"
    }
  }
}

Archives messages by id or by sender, on any inbox type. More than 5 messages returns a count to confirm first; more than 25 returns a preview and a confirmToken. Once connected agents have moved 500 messages in an hour, the person approves each further move (an in-app prompt, or an approvalUrl to give them). Pass items (inboxId and messageId per message) or sender. VIP mail is skipped in bulk and needs the person's confirmation one at a time. Every change returns an undoId. Not spam: that is propose_mark_spam then confirm_mark_spam.

Inputs

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "archive_messages",
    "arguments": {
      "items": [
        {
          "inboxId": "inbox_lx2k9a1b",
          "messageId": "18f3a2b4c5d6e7f8"
        }
      ]
    }
  }
}

Moves messages to Trash or Deleted Items, on any inbox type. Not a permanent delete. Trashing by sender skips mail from people. Same confirmation steps as archive_messages. Pass items (inboxId and messageId per message) or sender. VIP mail is skipped in bulk and needs the person's confirmation one at a time. Every change returns an undoId. Not spam: that is propose_mark_spam then confirm_mark_spam.

Inputs

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "trash_messages",
    "arguments": {
      "items": [
        {
          "inboxId": "inbox_lx2k9a1b",
          "messageId": "18f3a2b4c5d6e7f8"
        }
      ]
    }
  }
}

Stars messages, on any inbox type. Pass items (inboxId and messageId per message) or sender. VIP mail is skipped in bulk and needs the person's confirmation one at a time. Every change returns an undoId. Not spam: that is propose_mark_spam then confirm_mark_spam.

Inputs

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "star_messages",
    "arguments": {
      "items": [
        {
          "inboxId": "inbox_lx2k9a1b",
          "messageId": "18f3a2b4c5d6e7f8"
        }
      ]
    }
  }
}

Removes the star from messages, on any inbox type. Pass items (inboxId and messageId per message) or sender. VIP mail is skipped in bulk and needs the person's confirmation one at a time. Every change returns an undoId. Not spam: that is propose_mark_spam then confirm_mark_spam.

Inputs

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "unstar_messages",
    "arguments": {
      "items": [
        {
          "inboxId": "inbox_lx2k9a1b",
          "messageId": "18f3a2b4c5d6e7f8"
        }
      ]
    }
  }
}

Marks messages read, on any inbox type. Undo restores the previous state. Pass items (inboxId and messageId per message) or sender. VIP mail is skipped in bulk and needs the person's confirmation one at a time. Every change returns an undoId. Not spam: that is propose_mark_spam then confirm_mark_spam.

Inputs

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "mark_messages_read",
    "arguments": {
      "items": [
        {
          "inboxId": "inbox_lx2k9a1b",
          "messageId": "18f3a2b4c5d6e7f8"
        }
      ]
    }
  }
}

Marks messages unread, on any inbox type. Undo restores the previous state. Pass items (inboxId and messageId per message) or sender. VIP mail is skipped in bulk and needs the person's confirmation one at a time. Every change returns an undoId. Not spam: that is propose_mark_spam then confirm_mark_spam.

Inputs

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "mark_messages_unread",
    "arguments": {
      "items": [
        {
          "inboxId": "inbox_lx2k9a1b",
          "messageId": "18f3a2b4c5d6e7f8"
        }
      ]
    }
  }
}

Adds Gmail labels (labelIds from list_labels) to messages. Gmail only. Pass items (inboxId and messageId per message) or sender. VIP mail is skipped in bulk and needs the person's confirmation one at a time. Every change returns an undoId. Not spam: that is propose_mark_spam then confirm_mark_spam.

Inputs

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "label_messages",
    "arguments": {
      "items": [
        {
          "inboxId": "inbox_lx2k9a1b",
          "messageId": "18f3a2b4c5d6e7f8"
        }
      ],
      "labelIds": [
        "Label_1"
      ]
    }
  }
}

Removes Gmail labels (labelIds from list_labels) from messages. Gmail only. Pass items (inboxId and messageId per message) or sender. VIP mail is skipped in bulk and needs the person's confirmation one at a time. Every change returns an undoId. Not spam: that is propose_mark_spam then confirm_mark_spam.

Inputs

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "unlabel_messages",
    "arguments": {
      "items": [
        {
          "inboxId": "inbox_lx2k9a1b",
          "messageId": "18f3a2b4c5d6e7f8"
        }
      ],
      "labelIds": [
        "Label_1"
      ]
    }
  }
}

Hides messages from show_inbox until until (an ISO time with a UTC offset, within a year). Local to Inbox Triage: nothing changes in the mail app. Pass items (inboxId and messageId per message) or sender. VIP mail is skipped in bulk and needs the person's confirmation one at a time. Every change returns an undoId. Not spam: that is propose_mark_spam then confirm_mark_spam.

Inputs

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "snooze_messages",
    "arguments": {
      "items": [
        {
          "inboxId": "inbox_lx2k9a1b",
          "messageId": "18f3a2b4c5d6e7f8"
        }
      ],
      "until": "2026-10-12T09:00:00-05:00"
    }
  }
}

Clears a snooze so the messages show in show_inbox again. Pass items (inboxId and messageId per message) or sender. VIP mail is skipped in bulk and needs the person's confirmation one at a time. Every change returns an undoId. Not spam: that is propose_mark_spam then confirm_mark_spam.

Inputs

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "unsnooze_messages",
    "arguments": {
      "items": [
        {
          "inboxId": "inbox_lx2k9a1b",
          "messageId": "18f3a2b4c5d6e7f8"
        }
      ]
    }
  }
}

Starts the daily pass. Takes the triage lease and returns the next 10 messages that need the person, numbered, VIPs first, then people, then the rest, each with a suggested action and reason, and a batchId. The daily pass covers mail since the inbox was connected; catchUp:true works the backlog instead, mail that was there when you connected. ask:true asks the person in their app (hosts with form prompts); askedInApp says whether they answered. Clients that cannot ask get a decideUrl, a 30-minute page where the signed-in owner decides the batch.

Inputs

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "inbox_zero_start",
    "arguments": {}
  }
}

Applies decisions to a batch. Send the batchId back (a stale one is refused) with { n, action, until, reason } per row (archive, trash, snooze, star, label, leave, handled, reply), or rules over every undecided row. Returns the next batch, undoIds for each change, and draft hints for reply rows. handled also marks the message read. Never sends.

Inputs

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "inbox_zero_decide",
    "arguments": {}
  }
}

Holds (waitSeconds up to 45) until the person has decided the batch on the decideUrl page. Changes nothing itself.

Inputs

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "inbox_zero_wait",
    "arguments": {}
  }
}

Ends the inbox zero session, releases the lease and returns a one-line summary.

Inputs

No inputs.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "inbox_zero_stop",
    "arguments": {}
  }
}

Archives duplicate automated notifications, calendar replies older than 5 days, unread newsletters older than the person's newsletter age (default 14 days, defaults.cleanup.newsletterDays), and shipping updates for orders that have been delivered (the Delivered message stays), one undo for the whole run. Off until the person turns on defaults.cleanup.auto; until then it only lists what it would archive. With staleUnreadDays (7-365) it also archives unread automated mail older than that.

Inputs

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "run_cleanup",
    "arguments": {}
  }
}

Takes the per-inbox lease before a pass that changes mail.

Inputs

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "begin_triage",
    "arguments": {
      "inboxId": "inbox_lx2k9a1b",
      "agentLabel": "nightly-cleanup"
    }
  }
}

Extends the lease. Call it about every 2 minutes.

Inputs

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "heartbeat_triage",
    "arguments": {
      "inboxId": "inbox_lx2k9a1b",
      "agentLabel": "nightly-cleanup"
    }
  }
}

Releases the lease and records a summary.

Inputs

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "end_triage",
    "arguments": {
      "inboxId": "inbox_lx2k9a1b",
      "agentLabel": "nightly-cleanup"
    }
  }
}

Last pass and current lease for one inbox or all.

Inputs

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_triage_activity",
    "arguments": {}
  }
}