API Reference
Series
Create and manage multi-part article series on MisarBlog.
List Series
GET
/seriesReturns all series belonging to the authenticated creator.
Response fields
seriesArray<Series>The creator's series. Each entry includes id, slug, title, description, cover_image_url, visibility, created_at, and url.
{
"series": [
{
"id": "uuid",
"slug": "building-with-ai",
"title": "Building with AI",
"description": "A 5-part series on integrating AI into production apps.",
"cover_image_url": null,
"visibility": "public",
"created_at": "2026-01-10T00:00:00Z",
"url": "https://www.misar.blog/@johndoe/series/building-with-ai"
}
]
}Create a Series
POST
/seriesCreate a new series for the authenticated creator.
Request body
titlestringbodyrequiredSeries title.
descriptionstringbodyShort description.
{
"title": "Building with AI",
"description": "A 5-part series on integrating AI into production apps."
}{
"id": "uuid",
"slug": "building-with-ai",
"title": "Building with AI",
"url": "https://www.misar.blog/@johndoe/series/building-with-ai",
"created_at": "2026-04-15T09:00:00Z"
}Add an Article to a Series
POST
/series/{slug}/articlesAdds an existing published article to a series. Articles can only belong to one series.
Path parameters
slugstringpathrequiredSlug of the series to add the article to.
Request body
article_slugstringbodyrequiredSlug of an existing published article.
positionintegerbodyOrder within the series (1-based; appended if omitted).
Response fields
series_slugstringSlug of the series.
article_slugstringSlug of the added article.
article_titlestringTitle of the added article.
positionintegerThe article's position within the series.
{
"article_slug": "building-ai-apps-with-next-js",
"position": 1
}{
"series_slug": "building-with-ai",
"article_slug": "building-ai-apps-with-next-js",
"article_title": "Building AI Apps with Next.js",
"position": 1
}Errors
| Status | Description |
|---|---|
401 | Invalid or missing API key |
404 | Series or article not found |