WoyraDocs
Get an API key

What changed in a mailbox since a cursor

GET/v1/mailboxes/{id}/changes

Mailboxes · Requires an API key

Every mutation of the mailbox, whichever front door made it, oldest first: added, updated (flags, folder) and removed. Added and updated entries carry the message as it now is, so a client applies them without a second request. Omit since to start from the beginning; keep the returned cursor and pass it next time. Two clients on one mailbox converge on the same state.

Parameters

NameInDescription
idrequiredpath
sincequery
limitquery

Example

curl https://api.woyra.io/v1/mailboxes/email_01J.../changes \
  -H "Authorization: Bearer $WOYRA_KEY"

Response

200 The changes, and where to resume.

FieldTypeDescription
object"mail_changes"
changesarray of object
changes.kindstring
One of added, updated, removed.
changes.message_idstring
changes.messageMailMessageSummary
cursorstring
has_moreboolean

Errors

StatusCodes
400invalid_request, unsupported_version
404not_found, product_not_offered

Also in Mailboxes