Skip to main content
GET
Get Preferences
Read your notification, email, upload and sharing preferences. They follow your account to every device and match the settings on the website.

Behavior

  • notifications.likes covers post likes and comment likes.
  • Some notifications cannot be turned off and are not listed: mentions, shared posts, post removals and restrictions, and account changes. The same goes for security and transactional emails.
  • emails.sign_ins sends an email every time someone signs in to your account on the website. It is on by default.
  • uploads.default_privacy is what upload screens pre-select. The API never applies it: an upload without a post-privacy header is always private.
  • uploads.adaptive_streaming is on by default. The other upload toggles are off by default.
  • sharing.share_policy decides who can give you access to their private posts: everyone (default), following (only accounts you follow) or nobody. Changing it does not remove access you already have.
  • Shares a rate limit bucket with Update Preferences: 20 requests per minute.

Examples

Responses

Errors

Authorizations

relay-key
string
header
required

Your relay key from snipp.gg/settings/relay

Response

Success

notifications
object
required
emails
object
required
uploads
object
required
sharing
object
required