Emails
Update read or starred state
PATCH
/emails/{emailId}Provide at least one of isRead or isStarred. A body with neither is rejected rather than silently ignored.
Authorization
apiKey AuthorizationBearer <token>
Send your key as Authorization: Bearer mk_…. Session cookies are never accepted on this surface.
In: header
Path Parameters
emailId*string
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X PATCH "https://example.com/emails/string" \ -H "Authorization: Bearer $MAYLEE_KEY" \ -H "Content-Type: application/json" \ -d '{ "isRead": true }'{ "email": { "attachments": [ { "filename": "brief.pdf", "mimeType": "application/pdf", "size": 48213 } ], "bcc": [], "cc": [], "date": "2026-08-25T13:47:02.000Z", "folderId": "cmfd1a2b3c4d5e6f7g8h9i0j", "from": { "email": "client@acme.com", "name": "Jane Client" }, "hasAttachments": true, "id": "cmemx1a2b3c4d5e6f7g8h9i0", "inReplyTo": null, "isAutoForward": false, "isAutoReply": false, "isDraft": false, "isRead": false, "isStarred": false, "labels": [ "INBOX", "IMPORTANT" ], "mailboxId": "cmbx1a2b3c4d5e6f7g8h9i0j", "messageId": "<CAF3k9x1@mail.example.com>", "references": [], "scheduledSendAt": null, "scheduledStatus": null, "snippet": "Hello, could you send us a quote for the annual plan?", "subject": "Quote request", "threadId": "18c2f5a9e7b1d3c4", "to": [ { "email": "contact@your-company.com", "name": null } ], "waitingForReply": false }}