org.passingreads.book.rejectGift

Turn down a gift offered to the authenticated user, so it stops appearing in their account state. Deliberately appview-side only: nothing is written to the recipient's repository and the giver is never told, because a gift is an unsolicited message and being able to refuse one must not expose the refusal. The book never left the giver's hands, so refusing only hides the offer — there is nothing to hand back.

Details · procedure
Kindprocedure
Authoritybook.passingreads.org
Indexed

Procedure

procedure · POST

Input

application/json

gift

requiredstring · at-uri

The org.passingreads.book.event carrying the #gift being turned down. It must name the authenticated user as its recipient.

Output

application/json

rejectedAt

requiredstring · datetime

Errors

GiftNotFound

No indexed gift at that URI names the authenticated user as its recipient. Also the answer when a gift exists but was offered to somebody else, so the endpoint can't be used to probe for gifts.

ProfileNotFound

The authenticated DID has no PassingReads profile indexed by the appview.