Skip to content

Draft

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
id
required

The ID of a resource, a UUIDv7 in its canonical string form.

string format: uuid
created_at
required
string format: date-time
updated_at
required

When the draft was last saved.

string format: date-time
text
required

The plain text.

string
spoiler_text
required

The content warning; empty for none.

string
sensitive
required
boolean
language

A BCP 47 language tag; left out for the user’s default post language.

string
visibility
required

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.

string
Allowed values: public local unlisted private direct
in_reply_to_id

The ID of a resource, a UUIDv7 in its canonical string form.

string format: uuid
quoted_status_id

The ID of a resource, a UUIDv7 in its canonical string form.

string format: uuid
interaction_policy

Who may reply to, boost, and quote the post, of the kinds the user chose.

Schema: InteractionPolicyChange

object
media
required

The media to attach, in order.

Array<object>

A media file to attach, with its alternative text.

object
id
required

The ID of a resource, a UUIDv7 in its canonical string form.

string format: uuid
description

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.

string
<= 1500 characters
poll

Schema: DraftPoll

object
article

What makes the draft that of an article; left out for the draft of a post.

Schema: DraftArticle

object
scheduled_at

When the draft is scheduled to be published; left out while it is not scheduled.

string format: date-time
last_schedule

How the newest schedule that is over ended; left out when none ended.

Schema: DraftScheduleOutcome

object

Example generated

{
"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

Analytics on this site