Google Super

GOOGLESUPER_BATCH_MODIFY_MESSAGES

Modify labels on multiple Gmail messages in one efficient API call. Supports up to 1,000 messages per request for bulk operations like archiving, marking as read/unread, or applying custom labels.

Remote googlesuper

Other tools also called GOOGLESUPER_BATCH_MODIFY_MESSAGES? See providers with this name

Input Schema


            {
  "type": "object",
  "properties": {
    "userId": {
      "type": "string",
      "title": "User Id",
      "default": "me",
      "examples": [
        "me",
        "[email protected]"
      ],
      "description": "User's email address or 'me' for the authenticated user."
    },
    "messageIds": {
      "type": "array",
      "items": {
        "type": "string",
        "properties": {}
      },
      "title": "Message Ids",
      "examples": [
        [
          "18c5f5d1a2b3c4d5",
          "18c5f5d1a2b3c4d6"
        ],
        [
          "msg_id_1",
          "msg_id_2",
          "msg_id_3"
        ]
      ],
      "maxItems": 1000,
      "minItems": 1,
      "description": "List of message IDs to modify. Maximum 1,000 message IDs per request. Get message IDs from GMAIL_FETCH_EMAILS or GMAIL_LIST_THREADS actions."
    },
    "addLabelIds": {
      "type": "array",
      "items": {
        "type": "string",
        "properties": {}
      },
      "title": "Add Label Ids",
      "default": null,
      "examples": [
        [
          "INBOX",
          "STARRED"
        ],
        [
          "Label_123",
          "Label_456"
        ],
        [
          "IMPORTANT"
        ]
      ],
      "nullable": true,
      "description": "List of label IDs to add to the messages. Common label IDs: INBOX, STARRED, IMPORTANT, SENT, DRAFT, SPAM, TRASH, UNREAD. Use GMAIL_LIST_LABELS to get custom label IDs. Leave empty to skip adding labels."
    },
    "removeLabelIds": {
      "type": "array",
      "items": {
        "type": "string",
        "properties": {}
      },
      "title": "Remove Label Ids",
      "default": null,
      "examples": [
        [
          "UNREAD"
        ],
        [
          "INBOX",
          "UNREAD"
        ],
        [
          "SPAM"
        ]
      ],
      "nullable": true,
      "description": "List of label IDs to remove from the messages. Common use cases: Remove 'UNREAD' to mark as read, remove 'INBOX' to archive, remove 'SPAM' to unmark spam. Leave empty to skip removing labels."
    }
  }
}