Get Conversation

Inputs

• Provider conversation IDstringRequired

  conversationId

• 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?: { providerConversationId: string; 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[]; }; }