Skip to main content

Bulk Update Messages

POST/api/v1/mail/messages/bulk

Overview​

Apply bulk actions to multiple messages: mark as read/unread, archive, delete, or add a label.

Request Body​

message_idsarrayrequired

Array of message IDs (max 100)

actionstringrequired

Action to apply: mark_read, mark_unread, archive, delete, add_label

labelstring

Label name (required when action is add_label)

Request​

curl -X POST "https://spideriq.ai/api/v1/mail/messages/bulk" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <client_id>:<api_key>:<api_secret>" \
  -d '{
    "message_ids": [1, 2, 3],
    "action": "mark_read"
  }'

Response​

{
  "success": true,
  "updated_count": 3,
  "message": "Successfully applied 'mark_read' to 3 message(s)"
}