m365_move_email

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 mover correos de su cuenta de Microsoft 365 / Outlook a otra carpeta del servidor Exchange, para archivarlos u organizarlos. Indica los mensajes con message_id (uno) o message_ids (hasta 50), de m365_list_emails, m365_search_emails o m365_read_email; o una conversación completa con conversation_id (de m365_list_emails o m365_search_emails): entonces solo se mueven sus mensajes en source_folder (por defecto inbox), nunca sus copias en Elementos enviados, Borradores u otras carpetas, a menos que all_folders=true. destination es un id, nombre o ruta de carpeta de m365_list_email_folders, o inbox, archive, deleteditems, junkemail. Muestra primero una vista previa: establece confirm=true para mover. Un mensaje cuenta como movido solo cuando una segunda lectura lo muestra en el destino y ya no en su id anterior; un mensaje movido recibe un id nuevo (new_id). 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 move_email.

Entradas obligatorias

destination

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.

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"
    },
    "all_folders": {
      "description": "With conversation_id: true moves its messages from every folder, Sent Items and Drafts included (default false).",
      "type": "boolean"
    },
    "confirm": {
      "description": "Set to true to move (default: shows a preview only).",
      "type": "boolean"
    },
    "conversation_id": {
      "description": "Move the messages of this conversation that are in source_folder.",
      "type": "string"
    },
    "destination": {
      "description": "The folder to move them to: an id, name or path from m365_list_email_folders, or inbox, archive, deleteditems, junkemail.",
      "type": "string"
    },
    "message_id": {
      "description": "The ID of one message to move.",
      "type": "string"
    },
    "message_ids": {
      "description": "IDs of up to 50 messages to move.",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "source_folder": {
      "description": "With conversation_id: the folder its messages are moved from (default inbox). An id, name or path.",
      "type": "string"
    }
  },
  "required": [
    "destination"
  ],
  "type": "object"
}

Ejemplo documental

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

{
  "confirm": false,
  "destination": "archive",
  "message_id": "demo-message-001"
}

Windows