app.bsky.actor.defs

#profileViewBasic

Property	Type	Known Values	Required	Description
did	string (did)	-	✅	-
handle	string (handle)	-	✅	-
displayName	string	-	❌	-
avatar	string (uri)	-	❌	-
associated	#profileAssociated	-	❌	-
viewer	#viewerState	-	❌	-
labels	array of com.atproto.label.defs#label	-	❌	-
createdAt	string (datetime)	-	❌	-

#profileView

Property	Type	Known Values	Required	Description
did	string (did)	-	✅	-
handle	string (handle)	-	✅	-
displayName	string	-	❌	-
description	string	-	❌	-
avatar	string (uri)	-	❌	-
associated	#profileAssociated	-	❌	-
indexedAt	string (datetime)	-	❌	-
createdAt	string (datetime)	-	❌	-
viewer	#viewerState	-	❌	-
labels	array of com.atproto.label.defs#label	-	❌	-

#profileViewDetailed

Property	Type	Known Values	Required	Description
did	string (did)	-	✅	-
handle	string (handle)	-	✅	-
displayName	string	-	❌	-
description	string	-	❌	-
avatar	string (uri)	-	❌	-
banner	string (uri)	-	❌	-
followersCount	integer	-	❌	-
followsCount	integer	-	❌	-
postsCount	integer	-	❌	-
associated	#profileAssociated	-	❌	-
joinedViaStarterPack	app.bsky.graph.defs#starterPackViewBasic	-	❌	-
indexedAt	string (datetime)	-	❌	-
createdAt	string (datetime)	-	❌	-
viewer	#viewerState	-	❌	-
labels	array of com.atproto.label.defs#label	-	❌	-
pinnedPost	com.atproto.repo.strongRef	-	❌	-

#profileAssociated

Property	Type	Known Values	Required	Description
lists	integer	-	❌	-
feedgens	integer	-	❌	-
starterPacks	integer	-	❌	-
labeler	boolean	-	❌	-
chat	#profileAssociatedChat	-	❌	-

#profileAssociatedChat

Property	Type	Known Values	Required	Description
allowIncoming	string	all none following	✅	-

#viewerState

Metadata about the requesting account's relationship with the subject account. Only has meaningful content for authed requests.

Property	Type	Known Values	Required	Description
muted	boolean	-	❌	-
mutedByList	app.bsky.graph.defs#listViewBasic	-	❌	-
blockedBy	boolean	-	❌	-
blocking	string (at-uri)	-	❌	-
blockingByList	app.bsky.graph.defs#listViewBasic	-	❌	-
following	string (at-uri)	-	❌	-
followedBy	string (at-uri)	-	❌	-
knownFollowers	#knownFollowers	-	❌	-

#knownFollowers

The subject's followers whom you also follow

Property	Type	Known Values	Required	Description
count	integer	-	✅	-
followers	array of #profileViewBasic	-	✅	-

#preferences

Property	Type	Known Values	Required	Description
preferences	array of union #adultContentPref #contentLabelPref #savedFeedsPref #savedFeedsPrefV2 #personalDetailsPref #feedViewPref #threadViewPref #interestsPref #mutedWordsPref #hiddenPostsPref #bskyAppStatePref #labelersPref	-	❌	-

#adultContentPref

Property	Type	Known Values	Required	Description
enabled	boolean	-	✅	-

#contentLabelPref

Property	Type	Known Values	Required	Description
labelerDid	string (did)	-	❌	Which labeler does this preference apply to? If undefined, applies globally.
label	string	-	✅	-
visibility	string	ignore show warn hide	✅	-

#savedFeed

Property	Type	Known Values	Required	Description
id	string	-	✅	-
type	string	feed list timeline	✅	-
value	string	-	✅	-
pinned	boolean	-	✅	-

#savedFeedsPrefV2

Property	Type	Known Values	Required	Description
items	array of app.bsky.actor.defs#savedFeed	-	✅	-

#savedFeedsPref

Property	Type	Known Values	Required	Description
pinned	array of string	-	✅	-
saved	array of string	-	✅	-
timelineIndex	integer	-	❌	-

#personalDetailsPref

Property	Type	Known Values	Required	Description
birthDate	string (datetime)	-	❌	The birth date of account owner.

#feedViewPref

Property	Type	Known Values	Required	Description
feed	string	-	✅	The URI of the feed, or an identifier which describes the feed.
hideReplies	boolean	-	❌	Hide replies in the feed.
hideRepliesByUnfollowed	boolean	-	❌	Hide replies in the feed if they are not by followed users.
hideRepliesByLikeCount	integer	-	❌	Hide replies in the feed if they do not have this number of likes.
hideReposts	boolean	-	❌	Hide reposts in the feed.
hideQuotePosts	boolean	-	❌	Hide quote posts in the feed.

#threadViewPref

Property	Type	Known Values	Required	Description
sort	string	oldest newest most-likes random	❌	Sorting mode for threads.
prioritizeFollowedUsers	boolean	-	❌	Show followed users at the top of all replies.

#interestsPref

Property	Type	Known Values	Required	Description
tags	array of string	-	✅	A list of tags which describe the account owner's interests gathered during onboarding.

#mutedWordTarget

Property	Type	Known Values	Required	Description
mutedWordTarget	string	content tag	❌	-

#mutedWord

A word that the account owner has muted.

Property	Type	Known Values	Required	Description
id	string	-	❌	-
value	string	-	✅	The muted word itself.
targets	array of app.bsky.actor.defs#mutedWordTarget	-	✅	The intended targets of the muted word.
actorTarget	string	all exclude-following	❌	Groups of users to apply the muted word to. If undefined, applies to all users.
expiresAt	string (datetime)	-	❌	The date and time at which the muted word will expire and no longer be applied.

#mutedWordsPref

Property	Type	Known Values	Required	Description
items	array of app.bsky.actor.defs#mutedWord	-	✅	A list of words the account owner has muted.

#hiddenPostsPref

Property	Type	Known Values	Required	Description
items	array of string	-	✅	A list of URIs of posts the account owner has hidden.

#labelersPref

Property	Type	Known Values	Required	Description
labelers	array of #labelerPrefItem	-	✅	-

#labelerPrefItem

Property	Type	Known Values	Required	Description
did	string (did)	-	✅	-

#bskyAppStatePref

A grab bag of state that's specific to the bsky.app program. Third-party apps shouldn't use this.

Property	Type	Known Values	Required	Description
activeProgressGuide	#bskyAppProgressGuide	-	❌	-
queuedNudges	array of string	-	❌	An array of tokens which identify nudges (modals, popups, tours, highlight dots) that should be shown to the user.
nuxs	array of app.bsky.actor.defs#nux	-	❌	Storage for NUXs the user has encountered.

#bskyAppProgressGuide

If set, an active progress guide. Once completed, can be set to undefined. Should have unspecced fields tracking progress.

Property	Type	Known Values	Required	Description
guide	string	-	✅	-

#nux

A new user experiences (NUX) storage object

Property	Type	Known Values	Required	Description
id	string	-	✅	-
completed	boolean	-	✅	-
data	string	-	❌	Arbitrary data for the NUX. The structure is defined by the NUX itself. Limited to 300 characters.
expiresAt	string (datetime)	-	❌	The date and time at which the NUX will expire and should be considered completed.