list.md

title	description
list	app.bsky.graph.list

app.bsky.graph.list

#main

Properties

Record representing a list of accounts (actors). Scope includes both moderation-oriented lists and curration-oriented lists.

Use com.atproto.repo.createRecord to create a record.

Property	Type	Known Values	Required	Description
purpose	app.bsky.graph.defs#listPurpose	-	✅	-
name	string	-	✅	Display name for list; can not be empty.
description	string	-	❌	-
descriptionFacets	array of app.bsky.richtext.facet	-	❌	-
avatar	blob	-	❌	-
labels	union of com.atproto.label.defs#selfLabels	-	❌	-
createdAt	string (datetime)	-	✅	-

Output

Property	Type	Known Values	Required	Description
ref	com.atproto.repo.strongRef	-	✅	-