m365_mark_email_read

Microsoft 365 · macOS · Windows

Efecto: escritura. Estado: disponibilidad controlada.

«Disponibilidad controlada» significa que la herramienta figura en los artefactos publicados y puede depender de versión, plataforma, permisos, cuenta o configuración. Esta referencia no promete que esté activa en todas las instalaciones. Que una herramienta figure para macOS no implica que esté disponible en Windows, ni al revés.

macOS

Propósito

Úsala cuando el usuario quiera marcar como leídos correos de su cuenta de Microsoft 365 / Outlook, o como no leídos con unread=true: para dejar constancia de lo que ya se atendió, o para volver a un mensaje más tarde. Indica los mensajes con message_id (uno) o message_ids (hasta 20), de m365_list_emails, m365_search_emails o m365_read_email. Un mensaje cuenta como marcado solo cuando una segunda lectura muestra el nuevo estado. No se envía, mueve ni elimina nada, por lo que no pide confirmación. Necesita el permiso de Microsoft 365 Mail.ReadWrite: una cuenta conectada antes de que se pidiera responde consent_required hasta que se vuelva a conectar. Para el correo de la app Mail del Mac, usa mark_email_read.

Entradas obligatorias

El esquema de esta plataforma no declara entradas obligatorias. Aun así, pueden existir selectores opcionales o requisitos de ejecución.

Permisos y confirmación

El esquema no declara un parámetro explícito de confirmación. Esto no autoriza a actuar sin permiso: revisa el efecto y obtén autorización antes de una llamada real.

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.

Esquema técnico canónico en inglés — macOS

{
  "properties": {
    "account": {
      "description": "Which connected Microsoft 365 account to use: its email (UPN), its id from list_m365_accounts, or its display name when unique. Leave it out to use the default account.",
      "type": "string"
    },
    "message_id": {
      "description": "The ID of one message to mark.",
      "type": "string"
    },
    "message_ids": {
      "description": "IDs of up to 20 messages to mark.",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "unread": {
      "description": "true marks them as unread (default false: as read).",
      "type": "boolean"
    }
  },
  "type": "object"
}

Ejemplo documental

Ejemplo de documentación para m365_mark_email_read. 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.

{
  "message_id": "AAMkAGdemo-message-1"
}

Windows