Inbox

Search Inbox Emails

Search email threads across one or more mailboxes.

mailboxes is REQUIRED and an empty list is not "all mailboxes" - the inbox is per-mailbox, so an empty list is simply no result. Paging is on the query string, matching the app, because the body is the filter.

post/inbox/emails/search

Request

  • Base URL: https://be.graph8.com/api/v1
  • URL: https://be.graph8.com/api/v1/inbox/emails/search
  • Auth: HTTP bearer

Query parameters

pageinteger
page_sizeinteger

Headers

Authorizationstring nullable
X-Target-Org-Idstring nullable

Request body

mailboxesstring[] required

Mailbox addresses to search. REQUIRED: the inbox is per-mailbox, and an empty list is not 'all mailboxes', it is no result.

campaign_idsstring[] nullable
tag_idsstring[] nullable
exclude_tag_idsstring[] nullable
searchstring nullable
search_emailsstring[] nullable

Return threads touching ANY of these addresses, in the thread owner or in a message's from/to. OR-matched - a scope filter, not a full-text search.

status'SENT' | 'AI_RESPONDED' | 'DRAFT' nullable

Keep threads in one delivery state. Closed to the three the internal EmailStatus enum accepts - an open string here reaches a strict enum inside the handler and raises a bare pydantic.ValidationError, which no handler catches, so it escapes as a 500 instead of a 422.

updated_afterstring date-time nullable
updated_beforestring date-time nullable
sort_order'asc' | 'desc'
sort_by'updated_at' | 'created_at' | 'last_message_at'
assigned_to_user_emailstring nullable

Only threads assigned to this user.

Response

Successful Response

Changes

No recorded changes to this operation across all 2 revisions of this API.