**Version: 202601**

# Create article

**POST** `/openapi/2026-01/articles`

Create a new article with the provided details.

## Request

**application/json**

**Body | Example**

**Body (required)**

- `article` object (required)

  Article data to be created

  - `title` string (required)

    Article title. The title is required and must be between 1 and 100 characters

    **Possible values:** `<= 100 characters`
  - `excerpt` string

    Article summary/teaser text. The summary is optional and can be up to 255 characters

    **Possible values:** `<= 255 characters`
  - `content` string

    Full article content
  - `published` boolean

    Whether the article is published
  - `published_at` string

    Publication timestamp
  - `handle` string

    URL-friendly article identifier
  - `author` string

    Author name
  - `seo_title` string

    Custom SEO title
  - `seo_description` string

    SEO meta description
  - `seo_keywords` string[]

    SEO keywords
  - `blog_ids` string[]

    IDs of associated blogs/collections
  - `image` object

    Featured image object with URL

    - `src` string

      Image URL
    - `width` int32

      Width
    - `height` int32

      Height

```json
{
  "article": {
    "title": "string",
    "excerpt": "string",
    "content": "string",
    "published": true,
    "published_at": "string",
    "handle": "string",
    "author": "string",
    "seo_title": "string",
    "seo_description": "string",
    "seo_keywords": [
      "string"
    ],
    "blog_ids": [
      "string"
    ],
    "image": {
      "src": "string",
      "width": 0,
      "height": 0
    }
  }
}
```

## Responses

**200**

OK

**application/json**

**Schema | Example**

**Schema**

- `code` string

  error code
- `message` string

  error message
- `data` object

  - `article` object

    Article

    - `id` string

      Article ID
    - `title` string

      Title of the article
    - `excerpt` string

      Short summary or preview of the article content
    - `content` string

      Full content of the article
    - `image` object

      Image associated with the article containing src, width, height, and alt

      - `src` string

        Image URL
      - `width` int32

        Width
      - `height` int32

        Height
      - `path` string

        Path
    - `published` boolean

      Whether the article is published or not
    - `handle` string

      URL-friendly identifier for the article
    - `seo_title` string

      Custom SEO title
    - `seo_description` string

      SEO meta description
    - `seo_keywords` string[]

      SEO keywords
    - `author` string

      Author of the article
    - `published_at` string

      ISO 8601 timestamp when article was published
    - `blog_ids` string[]

      Array of blog IDs this article belongs to
    - `created_at` string

      ISO 8601 timestamp when article was created
    - `updated_at` string

      ISO 8601 timestamp when article was last updated

```json
{
  "code": "string",
  "message": "string",
  "data": {
    "article": {
      "id": "string",
      "title": "string",
      "excerpt": "string",
      "content": "string",
      "image": {
        "src": "string",
        "width": 0,
        "height": 0,
        "path": "string"
      },
      "published": true,
      "handle": "string",
      "seo_title": "string",
      "seo_description": "string",
      "seo_keywords": [
        "string"
      ],
      "author": "string",
      "published_at": "string",
      "blog_ids": [
        "string"
      ],
      "created_at": "string",
      "updated_at": "string"
    }
  }
}
```