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