app.bsky.draft.defs

#draftWithId

A draft with an identifier, used to store drafts in private storage (stash).

Property	Type	Known Values	Required	Description
id	string (tid)	-	✅	A TID to be used as a draft identifier.
draft	#draft	-	✅	-

#draft

A draft containing an array of draft posts.

Property	Type	Known Values	Required	Description
deviceId	string	-	❌	UUIDv4 identifier of the device that created this draft.
deviceName	string	-	❌	The device and/or platform on which the draft was created.
posts	array of #draftPost	-	✅	Array of draft posts that compose this draft.
langs	array of string	-	❌	Indicates human language of posts primary text content.
postgateEmbeddingRules	array of union app.bsky.feed.postgate#disableRule	-	❌	Embedding rules for the postgates to be created when this draft is published.
threadgateAllow	array of union app.bsky.feed.threadgate#mentionRule app.bsky.feed.threadgate#followerRule app.bsky.feed.threadgate#followingRule app.bsky.feed.threadgate#listRule	-	❌	Allow-rules for the threadgate to be created when this draft is published.

#draftPost

One of the posts that compose a draft.

Property	Type	Known Values	Required	Description
text	string	-	✅	The primary post content. It has a higher limit than post contents to allow storing a larger text that can later be refined into smaller posts.
labels	union of com.atproto.label.defs#selfLabels	-	❌	-
embedImages	array of #draftEmbedImage	-	❌	-
embedGallery	#draftEmbedGallery	-	❌	-
embedVideos	array of #draftEmbedVideo	-	❌	-
embedExternals	array of #draftEmbedExternal	-	❌	-
embedRecords	array of #draftEmbedRecord	-	❌	-

#draftView

View to present drafts data to users.

Property	Type	Known Values	Required	Description
id	string (tid)	-	✅	A TID to be used as a draft identifier.
draft	#draft	-	✅	-
createdAt	string (datetime)	-	✅	The time the draft was created.
updatedAt	string (datetime)	-	✅	The time the draft was last updated.

#draftEmbedLocalRef

Property	Type	Known Values	Required	Description
path	string	-	✅	Local, on-device ref to file to be embedded. Embeds are currently device-bound for drafts.

#draftEmbedCaption

Property	Type	Known Values	Required	Description
lang	string (language)	-	✅	-
content	string	-	✅	-

#draftEmbedGallery

Property	Type	Known Values	Required	Description
items	#draftEmbedGalleryItems	-	✅	-

#draftEmbedGalleryItems

Property	Type	Known Values	Required	Description
draftEmbedGalleryItems	array of union #draftEmbedImage	-	❌	The schema-level maxLength of 20 is a future-proof ceiling. Clients should currently enforce a soft limit of 10 items in authoring UIs.

#draftEmbedImage

Property	Type	Known Values	Required	Description
localRef	#draftEmbedLocalRef	-	✅	-
alt	string	-	❌	-

#draftEmbedVideo

Property	Type	Known Values	Required	Description
localRef	#draftEmbedLocalRef	-	✅	-
alt	string	-	❌	-
captions	array of #draftEmbedCaption	-	❌	-

#draftEmbedExternal

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

#draftEmbedRecord

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