Series

List Series

GET /series

Returns all series belonging to the authenticated creator.

Response

200 OK

{
  "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

Request Body

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

| Field | Type | Required | Description | |-------|------|----------|-------------| | title | string | Yes | Series title | | description | string | No | Short description | | slug | string | No | URL slug (auto-generated if omitted) |

Response

201 Created

{
  "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.

Request Body

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

| Field | Type | Required | Description | |-------|------|----------|-------------| | article_slug | string | Yes | Slug of an existing published article | | position | integer | No | Order within the series (1-based; appended if omitted) |

Response

200 OK

{ "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 |