DraftPage
A page of drafts, newest first.
object
An opaque pagination cursor. Clients pass it back unchanged and never parse it.
The drafts of the page.
A draft of a post or of an article (article), saved on the server so that the user goes on
writing it on another device, and publishes it at once or at a chosen time. Only the user reads
it; it is never federated.
object
The ID of a resource, a UUIDv7 in its canonical string form.
When the draft was last saved.
The plain text.
The content warning; empty for none.
A BCP 47 language tag; left out for 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 ID of a resource, a UUIDv7 in its canonical string form.
The ID of a resource, a UUIDv7 in its canonical string form.
Who may reply to, boost, and quote the post, of the kinds the user chose.
Schema: InteractionPolicyChange
object
The media to attach, in order.
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
What makes the draft that of an article; left out for the draft of a post.
Schema: DraftArticle
object
When the draft is scheduled to be published; left out while it is not scheduled.
How the newest schedule that is over ended; left out when none ended.
Schema: DraftScheduleOutcome
object
Example generated
{ "next_cursor": "example", "items": [ { "id": "01890a5d-ac96-774b-bcce-b302099a8057", "created_at": "2026-04-15T12:00:00Z", "updated_at": "2026-04-15T12:00:00Z", "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": {}, "scheduled_at": "2026-04-15T12:00:00Z", "last_schedule": {} } ]}For LLMs and coding agents:llms.txt,llms-full.txt, llms-small.txt