Skip to main content

Update Message

PATCH/api/v1/mail/messages/{id}

Overview​

Update message flags such as read status, star, and labels. All fields are optional — only provided fields are updated.

Path Parameters​

idintegerrequired

Message ID

Request Body​

is_readboolean

Mark as read or unread

is_starredboolean

Star or unstar the message

labelsarray

Set message labels (replaces existing labels)

Request​

curl -X PATCH "https://spideriq.ai/api/v1/mail/messages/1234" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <client_id>:<api_key>:<api_secret>" \
  -d '{
    "is_starred": true,
    "labels": ["hot-lead", "followup"]
  }'

Response​

{
  "success": true,
  "message": "Message updated"
}