Messages

Search messages (full-text, cross-inbox)

Full-text search across every inbox the key can see (tenant-, workspace-, or inbox-scoped automatically by key tier). Matches subject, plain-text body, and participant addresses. Returns lightweight hits — ids, participants, subject, receivedAt, hasAttachments, and a ~200-character snippet centred on the match — never htmlBody, so results stay small enough for an agent to consume in one call, then fetch the winning message/thread in full.

get/v1/messages/search

Request

  • Base URL: https://anjal.app
  • URL: https://anjal.app/v1/messages/search
  • Auth: API key in header X-API-Key

Query parameters

querystring

Full-text across subject, body, and participants.

inboxIdstring uuid

Scope to one inbox. Omit = all inboxes the key can see.

fromstring

Filter by sender address or domain (substring match).

tostring
participantstring

Match from OR to OR cc (address or domain).

direction'inbound' | 'outbound'
afterstring date-time
beforestring date-time
hasAttachmentboolean
attachmentFilenamestring

Match an attachment filename substring (e.g. invoice).

limitinteger
offsetinteger

Response

OK

totalCountinteger
nextOffsetinteger nullable

Changes

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