Search Messages

Inputs

• Search textstring

  query

• Subject containsstring

  subject

• From addressstring(email)

  from

• Received after (ISO timestamp)string

  receivedAfter

• Received before (ISO timestamp)string

  receivedBefore

• Include message bodiesbooleanRequired

  includeBody

• Maximum messagesintegerRequired

  limit

• Pagination cursorstring

  cursor

Output

{ schemaVersion: 1; provider: "google-gmail"; outcome: "complete" | "empty" | "partial" | "stale" | "unauthorized" | "forbidden" | "throttled" | "unavailable" | "malformed-provider"; mailbox?: { id: string; address: string }; data?: { messages: { providerMessageId: string; providerConversationId?: string; internetMessageId?: string; references?: string[]; historyId?: string; labelIds: string[]; subject?: string; bodyPreview?: string; body?: { contentType: "text" | "html"; content: string }; from?: { address: string; name?: string }; sender?: { address: string; name?: string }; replyTo: { address: string; name?: string }[]; to: { address: string; name?: string }[]; cc: { address: string; name?: string }[]; bcc: { address: string; name?: string }[]; sentAt?: string; receivedAt?: string; hasAttachments: boolean; isRead?: boolean; }[] }; nextCursor?: string; error?: { code: "complete" | "empty" | "partial" | "stale" | "unauthorized" | "forbidden" | "throttled" | "unavailable" | "malformed-provider"; message: string; retryAfterSeconds?: number }; evidence: { provider: "google-gmail"; operation: "search" | "message" | "conversation" | "attachment"; observedAt: string; providerRequests: number; durationMs: number; evidenceRefs: string[]; }; }