post

A piece of published content — a Reddit submission, HN story, YouTube upload, tweet, etc. Posts can contain media (videos, images, files). A comment is just a post that replies_to another post. Reviews extend post via also.

Metadata	Value
Plural	`posts`
Subtitle field	`author`
Identity	`platform`, `id`

Fields

Field	Type
`externalUrl`	`url`
`postType`	`string`

Relations

Relation	Target
`postedBy`	`account`
`publish`	`community`
`repliesTo`	`post`
`replies`	`post[]`
`contains`	`video[]`
`media`	`image[]`
`attachment`	`file[]`

Used as a base by

review

Prior art

External standards this shape draws from or aligns with. See Shape design principles for how prior art informs shape design.

ActivityStreams 2.0 (Note/Article + Create) — Fediverse post model. Our postedBy ≈ actor/attributedTo; publish(community) ≈ audience/to; repliesTo/replies ≈ inReplyTo/replies; media/attachment ≈ attachment.
OpenGraph protocol — How posts surface when linked. Our externalUrl + media[] correspond to og:url and og:image/og:video; postType loosely parallels og:type (article, video).
ATProto app.bsky.feed.post — Modern practical lexicon. Our repliesTo ≈ reply.parent; media ≈ embed.images; externalUrl ≈ embed.external.

Skills that produce this shape

hackernews — list_posts, search_posts, comments_post, get_post
youtube — list_posts
moltbook — list_posts, get_feed, list_comments, get_post
reddit — search_posts, list_posts, comments_post, get_post