DraftRequest
The whole content of a draft; a save replaces what the draft had. A draft keeps text that a
post would refuse (empty, or longer than max_post_characters), up to 100,000 characters, and
media that are still being processed; publishing it checks it as a new post.
object
The plain text; omitted or empty while there is none.
The content warning; omitted or empty for none. It counts toward max_post_characters.
Whether the media are sensitive.
A BCP 47 language tag; omitted means the user’s default post language.
Who may see a status: public everyone, listed on public timelines;
local logged-in users of this instance and followers; unlisted everyone, kept off
public timelines; private followers and mentioned accounts; direct mentioned
accounts.
The post to reply to, checked when the draft is scheduled and published.
The post to quote, checked when the draft is scheduled and published.
Who may reply to, boost, and quote the post; the kinds left out take the user’s
default_interaction_policy when the draft is published.
Schema: InteractionPolicyChange
object
The media to attach, in order: the user’s own uploads, processed or not. A draft with a
poll attaches none.
A media file to attach, with its alternative text.
object
The ID of a resource, a UUIDv7 in its canonical string form.
The alternative text; omitted or empty for none. While the instance requires alt
text (limits.require_media_description of GET /instance), a post or an edit
whose media file has none, or only spaces, is a 422.
Schema: DraftPoll
object
Schema: DraftArticleInput
object
Example generated
{ "text": "example", "spoiler_text": "example", "sensitive": true, "language": "example", "visibility": "public", "in_reply_to_id": "01890a5d-ac96-774b-bcce-b302099a8057", "quoted_status_id": "01890a5d-ac96-774b-bcce-b302099a8057", "interaction_policy": {}, "media": [ { "id": "01890a5d-ac96-774b-bcce-b302099a8057", "description": "example" } ], "poll": {}, "article": {}}For LLMs and coding agents:llms.txt,llms-full.txt, llms-small.txt