Method EraseAsync

Namespace: MailFathom.Application.Contacts

Assembly: MailFathom.Application.dll

EraseAsync(ContactId, CancellationToken)

Erases one person and everything the book derived from them.

public Task<ContactErasure> EraseAsync(ContactId contactId, CancellationToken cancellationToken)

Parameters

contactId ContactId: The contact to erase.
cancellationToken CancellationToken: Cancels the erasure.

Returns

Task<ContactErasure>: What the erasure removed.

Remarks

Erasure is not a write a writer's origin gates. It is the data-subject path, and a person asking to be removed from somebody's contact book is not answered with which half of the book they happen to be in.

It asks for the erasing grant rather than the writing one, beside the erasure of stored mail, because what it destroys cannot be written back and a credential provisioned to correct a record should not be able to remove one.

Exceptions

PrincipalNotAuthorizedException: Thrown when the erasure was reached by anything but a caller granted AdminErase.