Struct EmailImportInput 

pub struct EmailImportInput<'a> {
    pub blob_id: &'a Id,
    pub mailbox_ids: &'a [Id],
    pub keywords: Option<&'a [&'a str]>,
    pub received_at: Option<&'a UTCDate>,
    pub extra: Map<String, Value>,
}

Per-creation EmailImport object for Email/import (RFC 8621 §4.8).

The raw RFC 5322 message must already have been uploaded as a blob; the caller passes that blob’s id here. At least one mailbox id MUST be supplied; the empty case is rejected by email_import as InvalidArgument.

Fields

blob_id: &'a Id

Blob id of the uploaded raw RFC 5322 message.

mailbox_ids: &'a [Id]

Mailbox ids the new Email is assigned to. Wire shape is {id: true}; callers supply the set as a slice. At least one id is required (RFC 8621 §4.8).

keywords: Option<&'a [&'a str]>

Keywords to apply to the Email. Wire shape is {keyword: true}. Defaults to an empty map per RFC 8621 §4.8 when None.

received_at: Option<&'a UTCDate>

receivedAt to set on the imported Email. Defaults to the most recent Received header or import time per RFC 8621 §4.8 when None.

extra: Map<String, Value>

Catch-all for vendor / site / private extension fields not covered by the typed fields above. Preserves unknown fields across deserialize/serialize round-trip per workspace extras-preservation policy (see workspace AGENTS.md).

Constraint: keys in extra MUST NOT collide with the typed-field wire names above (the camelCase spelling — e.g. "accountId", "ids", "properties", "blobIds", "fromAccountId", etc.). On collision the typed-field value wins on the wire and the extra value is silently dropped at serialization. Place vendor extensions under vendor-prefixed keys (e.g. "acmeCorpFoo") to avoid the collision class.

Trait Implementations

impl<'a> Clone for EmailImportInput<'a>

fn clone(&self) -> EmailImportInput<'a>

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<'a> Debug for EmailImportInput<'a>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'a> Serialize for EmailImportInput<'a>

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.