v52

latestOpenAPI 3.0.3raw.githubusercontent.com2026-07-2113138232.4 KB
articles

Publish article

This endpoint allows the client to create a new article.

"Articles" are all the posts that users create on DEV/Forem that typically show up in the feed. They can be a blog post, a discussion question, a help thread etc. but are referred to as articles within the code.

Body Parameter Tips:

  • title: A compelling and descriptive title for the article.
  • body_markdown: The main text of the article in Markdown format. You can use standard Markdown as well as Forem-specific Liquid tags (e.g., {% embed ... %}). You can also include YAML front matter at the very beginning of the markdown to specify metadata such as tags, series, and cover image.
  • published: Set to true to immediately publish the article and make it visible in feeds. Set to false (default) to save it as a draft.
  • tags: A comma-separated list of tags (up to 4 tags). Tags help categorize your post and improve discoverability.
  • series: Group articles together by specifying a series name. If the series does not exist, it will be created.
  • main_image: Absolute URL of the cover image for the article.
  • canonical_url: If this post was originally published elsewhere, specify the canonical URL to maintain SEO integrity.
  • description: A short summary of the article used for previews and SEO meta description.
post/api/articles

Request body

Response

An Article