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
Kindquery
Authorityactor.bivri.app
Indexed

Query

query · GET

Output

application/json

How 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.

The 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.

The caller's normalized muted Tags. A current server returns an empty array when none were stored.

The 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 match

Lexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.

  • Replace 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.

  • town.delve.notification.getPreferences

    query not from the namespace authority

    Get notification-related preferences for an account. Requires auth.