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
| Kind | procedure |
|---|---|
| Authority | book.passingreads.org |
| Indexed |
Procedure
procedure · POSTInput
application/jsonThe org.passingreads.book.event carrying the #gift being turned down. It must name the authenticated user as its recipient.
Output
application/jsonErrors
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.