app.bivri.actor.getPreferences
Read the authenticated account's own preferences. Scoped to the caller and to nobody else: there is no parameter naming whose preferences to read, because one account's preferences are never another account's business. An account that has never set a preference reads the defaults rather than an absence, so a client has nothing to guess.
Details · query
| Kind | query |
|---|---|
| Authority | actor.bivri.app |
| Indexed |
Query
query · GETOutput
application/jsonHow the caller wants self-labelled Artwork presented. Optional on the wire for the same reason as interests; a current server always returns it, with suggestive and spoiler set to blur and the AI labels set to show when nothing was stored.
interests
refThe caller's durable interest Tags. Optional on the wire because adding it to required would break clients of the published preference schema; an absent value means an older server, while a current server returns an empty array when no interests were stored.
mutedTags
refThe caller's normalized muted Tags. A current server returns an empty array when none were stored.
mutedWords
refThe caller's normalized muted words. A current server returns an empty array when none were stored.
Errors
Unauthenticated
Nobody is authenticated, so there are no preferences to read.
Similar lexicons
semantic matchLexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.
-
app.bivri.actor.putPreferences
procedureReplace the authenticated account's own preferences. Every group sent is replaced whole and every group omitted is left as it was, so a client that knows about one group cannot silently reset another it has never heard of. Sending the same preferences twice is the same as sending them once. Preferences are the account's alone: nothing here names another account, and nothing here is served to one.
-
Get notification-related preferences for an account. Requires auth.
-
Get the private user preferences associated to the account.
-
Gets the requesting user's own settings, as the AppView currently holds them.
-
Get notification-related preferences for an account. Requires auth.