Mailboxes

List threads in a mailbox

Returns thread summaries, most recent activity first. after and before filter by last activity, so an agent polling for new mail passes the last time it looked. q is a full-text search over subjects, senders, and message text; folder, label, unread, and starred narrow the list. Pass nextCursor back as cursor for the next page; it is null on the last page. A thread that gains activity while you page moves ahead of the cursor, so a walk lists each thread at most once.

get/v1/mailboxes/{id}/threads

Request

  • Base URL: https://api.samva.dev
  • URL: https://api.samva.dev/v1/mailboxes/{id}/threads
  • Auth: API key in header x-api-key

Path parameters

idstring required

Query parameters

limitstring nullable
cursorstring
afterstring nullable
beforestring nullable
qstring nullable
folder'inbox' | 'assigned' | 'pending' | 'sent' | 'archived' | 'trash'
labelstring
unread'true' | 'false' nullable
starred'true' | 'false' nullable
snoozed'true' | 'false' nullable

Response

MailboxThreadPage

nextCursorstring nullable required

Changes

No recorded changes to this operation across all 1 revision of this API.