List Series

GET/series

Returns all series belonging to the authenticated creator.

Response fields

dataArray<Series>

The creator's series. Each entry includes id, slug, title, description, article_count, and created_at.

{
  "data": [
    {
      "id": "uuid",
      "slug": "building-with-ai",
      "title": "Building with AI",
      "description": "A 5-part series on integrating AI into production apps.",
      "article_count": 3,
      "created_at": "2026-01-10T00:00:00Z"
    }
  ]
}

Create a Series

POST/series

Create a new series for the authenticated creator.

Request body

titlestringbodyrequired

Series title.

descriptionstringbody

Short description.

slugstringbody

URL slug (auto-generated if omitted).

{
  "title": "Building with AI",
  "description": "A 5-part series on integrating AI into production apps.",
  "slug": "building-with-ai"
}

{
  "id": "uuid",
  "slug": "building-with-ai",
  "title": "Building with AI",
  "created_at": "2026-04-15T09:00:00Z"
}

Add an Article to a Series

POST/series/{slug}/articles

Adds an existing published article to a series. Articles can only belong to one series.

Path parameters

slugstringpathrequired

Slug of the series to add the article to.

Request body

article_slugstringbodyrequired

Slug of an existing published article.

positionintegerbody

Order within the series (1-based; appended if omitted).

Response fields

successboolean

true when the article was added.

positioninteger

The article's position within the series.

{
  "article_slug": "building-ai-apps-with-next-js",
  "position": 1
}

{ "success": true, "position": 1 }

Errors

Status	Description
`401`	Invalid or missing API key
`404`	Series or article not found
`409`	Article already belongs to a series