flag_email

macOS

Propósito

Marca un correo en Apple Mail (Mail.app) del Mac con un color, o quita su marca. color es uno de red, orange, yellow, green, blue, purple, gray, o none para quitarla (por defecto red). La respuesta es lo que Mail lee de vuelta tras el cambio. Pasa account= y mailbox= (de list_emails/search_emails) para que el mensaje se encuentre sin recorrer buzones. Si se llama sin confirm, devuelve una vista previa y no cambia nada; pasa confirm=true para marcarlo.

Entradas obligatorias

• message_id

Los nombres se conservan exactamente como los exige la herramienta. Las definiciones técnicas canónicas, en inglés, están en el esquema expandible de abajo.

Permisos y confirmación

El esquema declara un parámetro explícito de confirmación. Revisa la vista previa y autoriza la operación real según el contrato de esta plataforma.

• Utilice únicamente las aplicaciones, cuentas y recursos autorizados por el usuario en esta plataforma. Consulte la descripción específica de la plataforma de esta herramienta para conocer sus requisitos de conexión y permisos. Este catálogo no afirma alcances OAuth adicionales ni derechos de sistema operativo.

{
  "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"
}

Ejemplo documental

Ejemplo de documentación para flag_email. No ejecutes este ejemplo. Los argumentos mostrados pertenecen a un conjunto de datos ficticio; resuelve identificadores reales y obtén autorización antes de una llamada real.

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