Mail

Assign (`assignedUserId`) or unassign (`null`) a mailbox to an org member.

assign(input: OrgScoped<{ id: string; assignedUserId: string | null; }>): Promise<{ mailbox: Mailbox; }>;

Provision a mailbox. Returns the row + the plaintext `password` ONCE (the password is never re-readable). 409 `mailbox_taken` if the address exists; 400/403 if the domain isn't added/verified; 404 `member_not_found` if the assigned user isn't an org member.

create(input: OrgScoped<MailboxCreateInput>): Promise<MailboxCreated>;

Deprovision a mailbox (and its mail-store entry).

delete(input: OrgScoped<{ id: string; }>): Promise<{ ok: true; }>;

get(input: OrgScoped<{ id: string; }>): Promise<{ mailbox: Mailbox; }>;

The org's mailboxes (newest first).

list(input?: OrgScoped): Promise<{ mailboxes: Mailbox[]; }>;

get(input: OrgScoped<{ id: string; }>): Promise<{ message: MailMessage; }>;

The org's send-log (newest first).

list(input?: OrgScoped): Promise<{ messages: MailMessage[]; }>;

The headline service: resolve the verified sender domain, DKIM-sign in the API, check suppressions, relay. Returns the send-log row (status `sent`).

send(input: OrgScoped<MailSendInput>): Promise<{ message: MailMessage; }>;

Add an address to the suppression list (`reason` defaults to "manual").

add(input: OrgScoped<{ email: string; reason?: MailSuppressionReason; note?: string; }>): Promise<{ suppression: MailSuppression; }>;

list(input?: OrgScoped): Promise<{ suppressions: MailSuppression[]; }>;

remove(input: OrgScoped<{ email: string; }>): Promise<{ ok: true; }>;