flag_email

macOS

Doel

Markeert een e-mail in Apple Mail (Mail.app) op de Mac met een kleur, of wist de markering. color is een van red, orange, yellow, green, blue, purple, gray, of none om te wissen (standaard red). Het antwoord is wat Mail na de wijziging teruglees. Geef account= en mailbox= mee (uit list_emails/search_emails) zodat het bericht zonder scannen wordt gevonden. Zonder confirm geeft het een voorbeeld terug en wijzigt het niets; geef confirm=true mee om te markeren.

Vereiste invoer

• message_id

De namen blijven exact zoals het hulpmiddel ze vereist. De canonieke technische definities in het Engels staan in het uitklapbare schema hieronder.

Machtigingen en bevestiging

Het schema bevat een expliciete bevestigingsparameter. Controleer het voorbeeld en autoriseer de echte bewerking volgens het platformcontract.

• Gebruik uitsluitend de apps, accounts en bronnen waarvoor de gebruiker op dit platform toestemming heeft gegeven. Raadpleeg de platformspecifieke beschrijving van deze tool voor de verbindings- en toestemmingsvereisten; deze catalogus veronderstelt geen aanvullende OAuth-bereiken of OS-rechten.

{
  "properties": {
    "account": {
      "description": "Mail.app account the message lives in (returned alongside the id). Pass it so the message is found in the right account.",
      "type": "string"
    },
    "color": {
      "description": "red, orange, yellow, green, blue, purple, gray, or none to clear the flag. Default red.",
      "type": "string"
    },
    "confirm": {
      "default": "false",
      "description": "Set to true to actually flag the message. Defaults to false.",
      "type": "boolean"
    },
    "mailbox": {
      "description": "Folder the message is in. Passing it skips searching the other folders.",
      "type": "string"
    },
    "message_id": {
      "description": "The message id returned by list_emails or search_emails. Accepts the bare id or the <angle-bracketed> form.",
      "type": "string"
    }
  },
  "required": [
    "message_id"
  ],
  "type": "object"
}

Documentatievoorbeeld

Documentatievoorbeeld voor flag_email. Voer dit voorbeeld niet uit. De getoonde argumenten verwijzen naar fictieve gegevens; zoek vóór een echte aanroep de werkelijke identificatoren op en vraag toestemming.

{
  "account": "Demo iCloud",
  "color": "orange",
  "confirm": false,
  "mailbox": "INBOX",
  "message_id": "demo-message-001"
}