StatusEdit
One revision of a status.
object
The text of the revision as sanitized HTML; for an article, its body.
The title and summary of the revision of an article; omitted for a post.
Schema: StatusEditArticle
object
The content warning of the revision; empty when there is none.
Whether the media of the revision are sensitive.
When the revision was made; the first one is when the status was posted.
The media the revision attaches, in order.
A media file, as an upload of the user (the media operations) or as an attachment of
a status (Status.media_attachments). url, preview_url, variants, and blurhash
are present once the file is ready; statuses attach only ready files. In a status,
description is the status revision’s own copy of the alternative text, absent when the
attachment has none.
A file of a remote status is always ready: the instance does not process it, so it has
no variants; url and preview_url are its media proxy URLs,
remote_url its URL on the remote server, and meta, blurhash, and type what the
remote server declared.
object
The ID of a resource, a UUIDv7 in its canonical string form.
The kind of media. An accepted upload is an image, a video, or an audio file;
a file that failed processing is unknown. gifv is a remote video that plays like
an animated image: muted, looped, without controls.
The processing state: processing until the server has re-encoded the file,
then ready, or failed when the content could not be processed.
The alternative text; absent when there is none.
The blurhash (https://blurha.sh) of the image, to show while it loads.
Schema: MediaMeta
object
Schema: MediaVariants
object
Where the file is served on this instance; for an upload, variants.large.url, or
variants.animated.large.url for an animation, and the file itself for a video or
audio file.
Where its preview is served; for an upload, variants.small.url (still). A video or
audio file without a poster has none.
The file’s URL on the remote server, for a file of a remote status; clients load url instead.
The custom emoji of the revision’s text and content warning, as Status.emojis.
A custom emoji that a text uses. The text has it as :shortcode:.
An emoji that is disabled or deleted, or whose images come from a domain whose media the
instance rejects, is not listed, and its :shortcode: stays text. Clients show
static_url when animations should not play (prefers-reduced-motion), and url
otherwise.
object
The shortcode, without the colons around it.
The URL of the image, animated when the emoji is.
The URL of a still image of the emoji; the same as url when no still version is served.
Example generated
{ "content": "example", "article": {}, "spoiler_text": "example", "sensitive": true, "created_at": "2026-04-15T12:00:00Z", "media_attachments": [ { "id": "01890a5d-ac96-774b-bcce-b302099a8057", "type": "image", "state": "processing", "description": "example", "blurhash": "example", "meta": {}, "variants": {}, "url": "https://example.com", "preview_url": "https://example.com", "remote_url": "https://example.com" } ], "emojis": [ { "shortcode": "example", "url": "https://example.com", "static_url": "https://example.com" } ]}For LLMs and coding agents:llms.txt,llms-full.txt, llms-small.txt