Email

The `Email` entity.

Definition

TypeScript

interface Email {
  id: string;
  workspaceId: string;
  messageId: string | null;
  inReplyTo: string | null;
  references: string | null;
  subject: string | null;
  from: { name: string; address: string } | null;
  sender: { name: string; address: string } | null;
  to: Array<{ name: string; address: string }>;
  cc: Array<{ name: string; address: string }>;
  bcc: Array<{ name: string; address: string }>;
  replyTo: Array<{ name: string; address: string }>;
  date: string | null;
  bodyPreview: string;
  bodyPreviewTruncated: boolean;
  rawSize: number;
  attachmentCount: number;
  receivedAt: string;
  createdAt: string;
  updatedAt: string;
}

Fields

Field	Type	Notes
`id`	`string`	`readonly` `required`
`workspaceId`	`string`	`required` — Workspace that received this email.
`messageId`	`string \| null`	`required` — RFC-5322 Message-ID header value.
`inReplyTo`	`string \| null`	`required` — Message-ID of the email this one replies to, if any.
`references`	`string \| null`	`required` — Space-separated list of referenced Message-IDs for threading.
`subject`	`string \| null`	`required` — Subject header, if present.
`from`	`{ name: string; address: string; } \| null`	`required` — Author per the From header.
`sender`	`{ name: string; address: string; } \| null`	`required` — Actual sender per the Sender header, if it differs from From.
`to`	`Array<{ name: string; address: string; }>`	`required` — Primary recipients (To header).
`cc`	`Array<{ name: string; address: string; }>`	`required` — Carbon-copy recipients (Cc header).
`bcc`	`Array<{ name: string; address: string; }>`	`required` — Blind-carbon-copy recipients (Bcc header), if exposed by transport.
`replyTo`	`Array<{ name: string; address: string; }>`	`required` — Addresses clients should reply to (Reply-To header).
`date`	`string \| null`	`required` — Date header parsed as ISO-8601; null when missing or invalid.
`bodyPreview`	`string`	`required` — Plaintext preview snippet of the email body.
`bodyPreviewTruncated`	`boolean`	`required` — True when the preview is truncated vs. the full body.
`rawSize`	`number`	`required` — Size in bytes of the raw .eml payload stored in R2.
`attachmentCount`	`number`	`required` — Number of attachments parsed from the message.
`receivedAt`	`string`	`required` — ISO-8601 timestamp when the email worker received the message.
`createdAt`	`string`	`readonly` `required` — ISO-8601 timestamp of creation.
`updatedAt`	`string`	`readonly` `required` — ISO-8601 timestamp of the last update.