app.bivri.actor.getPreferences

lexicons.bivri.app

Documentation

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.

main query

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.

Output

Encodingapplication/json
contentFilters refapp.bivri.actor.defs#contentFilterPreferences Optional

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.

interests refapp.bivri.actor.defs#interestPreferences Optional

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.

Errors

Unauthenticated Nobody is authenticated, so there are no preferences to read.
Try It

Requests are sent directly from your browser. Some servers may block requests due to CORS.

Base URL for XRPC calls (e.g., https://api.bsky.social)
View raw schema
{
  "description": "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.",
  "errors": [
    {
      "description": "Nobody is authenticated, so there are no preferences to read.",
      "name": "Unauthenticated"
    }
  ],
  "output": {
    "encoding": "application/json",
    "schema": {
      "properties": {
        "contentFilters": {
          "description": "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.",
          "ref": "app.bivri.actor.defs#contentFilterPreferences",
          "type": "ref"
        },
        "interests": {
          "description": "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.",
          "ref": "app.bivri.actor.defs#interestPreferences",
          "type": "ref"
        },
        "mutedTags": {
          "description": "The caller's normalized muted Tags. A current server returns an empty array when none were stored.",
          "ref": "app.bivri.actor.defs#mutedTagPreferences",
          "type": "ref"
        },
        "mutedWords": {
          "description": "The caller's normalized muted words. A current server returns an empty array when none were stored.",
          "ref": "app.bivri.actor.defs#mutedWordPreferences",
          "type": "ref"
        },
        "notifications": {
          "ref": "app.bivri.actor.defs#notificationPreferences",
          "type": "ref"
        }
      },
      "required": [
        "notifications"
      ],
      "type": "object"
    }
  },
  "type": "query"
}

Lexicon Garden

@