---
metadata:
  - name: generator
    content: Diplodoc Platform v5.54.2
alternate:
  - https://yandex.ru/dev/kit/ru/openapi/Novosti/CreateBlog.md
  - href: ru/openapi/Novosti/CreateBlog.md
    type: text/markdown
    title: Markdown version
  - href: ../../llms.txt
    type: text/markdown
    title: llms.txt
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/kit/ru/llms.txt

<div class="openapi">

# Создание новости

<!-- markdownlint-disable-file -->

Создает новость.

## Request

<div class="openapi__requests">

<div class="openapi__request__wrapper" style="--method: var(--dc-openapi-methods-post);margin-bottom: 12px">

<div class="openapi__request">

POST {.openapi__method}
```text translate=no
https://api.kit.yandex.net/v1/blogs
```

</div>

</div>

</div>

<div class="openapi-entity">

### Body

{% cut "application/json" %}

```json translate=no
{
  "slug": "example",
  "title": "example",
  "short_description": "example",
  "is_short_description_auto_generated": true,
  "content": "example",
  "blog_dates": {
    "start_date": "2025-01-01T00:00:00Z",
    "end_date": "2025-01-01T00:00:00Z"
  },
  "tags": [
    "example"
  ],
  "seo_title": "example",
  "seo_h1": "example",
  "seo_description": "example",
  "desktop_media": [
    {
      "type": "IMAGE",
      "display_sequence": 1,
      "image_id": "019b30d4-3e28-7a98-ae46-cb66932d1936",
      "video_id": "vplvusemmooxmhpwiqli"
    }
  ],
  "mobile_media": [
    null
  ],
  "preview_media": [
    null
  ],
  "attachment": {
    "type": "CATEGORY",
    "id": "019b21d9-c5d9-777d-80bd-d67c664bc6d9"
  },
  "status": "ACTIVE"
}
```

{% endcut %}

#|
|| **Name** | **Description** ||
||

_blog_dates_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: [BlogDates](#entity-BlogDates)

Даты действия новости.

{% cut "**Example**" %}{.json-schema-example}

```json translate=no
{
  "start_date": "2025-01-01T00:00:00Z",
  "end_date": "2025-01-01T00:00:00Z"
}
```

{% endcut %}
{.table-cell}
||
||

_content_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

Содержимое новости.

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||

_status_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: [BlogStatus](#entity-BlogStatus)

Статус публикации новости.

_Enum:_{.json-schema-reset .json-schema-value} `ACTIVE`, `INACTIVE`
{.table-cell}
||
||

_tags_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string[]

Теги новости.

{% cut "**Example**" %}{.json-schema-example}

```json translate=no
[
  "example"
]
```

{% endcut %}
{.table-cell}
||
||

_title_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

Заголовок новости.

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||

_attachment_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: [BlogAttachment](#entity-BlogAttachment)

Связанная сущность.

{% cut "**Example**" %}{.json-schema-example}

```json translate=no
{
  "type": "CATEGORY",
  "id": "019b21d9-c5d9-777d-80bd-d67c664bc6d9"
}
```

{% endcut %}
{.table-cell}
||
||

_desktop_media_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: [VariantMedia](#entity-VariantMedia)[]

Медиа для отображения в версии для компьютера.

{% cut "**Example**" %}{.json-schema-example}

```json translate=no
[
  {
    "type": "IMAGE",
    "display_sequence": 1,
    "image_id": "019b30d4-3e28-7a98-ae46-cb66932d1936",
    "video_id": "vplvusemmooxmhpwiqli"
  }
]
```

{% endcut %}
{.table-cell}
||
||

_is_short_description_auto_generated_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: boolean

Сгенерировать краткое описание автоматически.
{.table-cell}
||
||

_mobile_media_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: [VariantMedia](#entity-VariantMedia)[]

Медиа для отображения на мобильном устройстве.

{% cut "**Example**" %}{.json-schema-example}

```json translate=no
[
  {
    "type": "IMAGE",
    "display_sequence": 1,
    "image_id": "019b30d4-3e28-7a98-ae46-cb66932d1936",
    "video_id": "vplvusemmooxmhpwiqli"
  }
]
```

{% endcut %}
{.table-cell}
||
||

_preview_media_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: [VariantMedia](#entity-VariantMedia)[]

Медиа для отображения в превью.

{% cut "**Example**" %}{.json-schema-example}

```json translate=no
[
  {
    "type": "IMAGE",
    "display_sequence": 1,
    "image_id": "019b30d4-3e28-7a98-ae46-cb66932d1936",
    "video_id": "vplvusemmooxmhpwiqli"
  }
]
```

{% endcut %}
{.table-cell}
||
||

_seo_description_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string

SEO описание новости.

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||

_seo_h1_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string

SEO H1 новости.

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||

_seo_title_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string

SEO заголовок новости.

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||

_short_description_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string

Краткое описание.

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||

_slug_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string

URL-идентификатор новости.

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
|#{.json-schema-properties}

</div>

<div class="openapi-entity">

### BlogDates {#entity-BlogDates}

Даты действия новости.

#|
|| **Name** | **Description** ||
||

_start_date_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string&lt;date-time&gt;

Дата публикации новости.

_Example:_{.json-schema-reset .json-schema-example} `2025-01-01T00:00:00Z`
{.table-cell}
||
||

_end_date_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string&lt;date-time&gt;

_Example:_{.json-schema-reset .json-schema-example} `2025-01-01T00:00:00Z`
{.table-cell}
||
|#{.json-schema-properties}

{% cut "**Example**" %}{.json-schema-example}

```json translate=no
{
  "start_date": "2025-01-01T00:00:00Z",
  "end_date": "2025-01-01T00:00:00Z"
}
```

{% endcut %}

</div>

<div class="openapi-entity">

### FileType {#entity-FileType}

Тип файла.

**Type**: string

_Enum:_{.json-schema-reset .json-schema-value} `IMAGE`, `VIDEO`, `OTHER`

</div>

<div class="openapi-entity">

### FileID {#entity-FileID}

Идентификатор файла.

**Type**: string&lt;uuid&gt;

_Example:_{.json-schema-reset .json-schema-example} `019b30d4-3e28-7a98-ae46-cb66932d1936`

</div>

<div class="openapi-entity">

### VariantMedia {#entity-VariantMedia}

Медиафайлы товара (изображения и видео).

#|
|| **Name** | **Description** ||
||

_display_sequence_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: integer

Порядок отображения.
{.table-cell}
||
||

_type_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: [FileType](#entity-FileType)

Тип файла.

_Enum:_{.json-schema-reset .json-schema-value} `IMAGE`, `VIDEO`, `OTHER`
{.table-cell}
||
||

_image_id_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: [FileID](#entity-FileID)

Идентификатор файла.

_Example:_{.json-schema-reset .json-schema-example} `019b30d4-3e28-7a98-ae46-cb66932d1936`
{.table-cell}
||
||

_video_id_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string

Идентификатор видео (для `type: VIDEO`). Видео нужно предварительно загрузить
через `POST /v1/videos` или `POST /v1/videos/from_url`.


Максимум одно видео на товар. В `media` требуется минимум одно изображение:
при отсутствии элемента `type: IMAGE` запрос завершится с ошибкой.

Привязанное видео может быть в любом статусе, но покупателям оно доступно
для просмотра только после перехода в статус `READY`.

_Example:_{.json-schema-reset .json-schema-example} `vplvusemmooxmhpwiqli`
{.table-cell}
||
|#{.json-schema-properties}

{% cut "**Example**" %}{.json-schema-example}

```json translate=no
{
  "type": "IMAGE",
  "display_sequence": 1,
  "image_id": "019b30d4-3e28-7a98-ae46-cb66932d1936",
  "video_id": "vplvusemmooxmhpwiqli"
}
```

{% endcut %}

</div>

<div class="openapi-entity">

### BlogAttachmentType {#entity-BlogAttachmentType}

Тип сущности привязанной к новости (категория или коллекция).
К новости можно привязать только одну сущность.

**Type**: string

_Enum:_{.json-schema-reset .json-schema-value} `CATEGORY`, `COLLECTION`

</div>

<div class="openapi-entity">

### CategoryID {#entity-CategoryID}

Идентификатор категории.

**Type**: string&lt;uuid&gt;

_Example:_{.json-schema-reset .json-schema-example} `019b21d9-c5d9-777d-80bd-d67c664bc6d9`

</div>

<div class="openapi-entity">

### CollectionID {#entity-CollectionID}

Идентификатор коллекции.

**Type**: string&lt;uuid&gt;

_Example:_{.json-schema-reset .json-schema-example} `019b21d9-c5d9-777d-80bd-d67c664bc6d9`

</div>

<div class="openapi-entity">

### BlogAttachment {#entity-BlogAttachment}

#|
|| **Name** | **Description** ||
||

_id_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
{% cut "**One of 2 types**" %}{.json-schema-combinators data-marker=or}

- **Type**: [CategoryID](#entity-CategoryID)

  Идентификатор категории.

  _Example:_{.json-schema-reset .json-schema-example} `019b21d9-c5d9-777d-80bd-d67c664bc6d9`

- **Type**: [CollectionID](#entity-CollectionID)

  Идентификатор коллекции.

  _Example:_{.json-schema-reset .json-schema-example} `019b21d9-c5d9-777d-80bd-d67c664bc6d9`

{% endcut %}

Идентификатор сущности привязанной к новости.

_Example:_{.json-schema-reset .json-schema-example} `019b21d9-c5d9-777d-80bd-d67c664bc6d9`
{.table-cell}
||
||

_type_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: [BlogAttachmentType](#entity-BlogAttachmentType)

Тип сущности привязанной к новости (категория или коллекция).
К новости можно привязать только одну сущность.

_Enum:_{.json-schema-reset .json-schema-value} `CATEGORY`, `COLLECTION`
{.table-cell}
||
|#{.json-schema-properties}

{% cut "**Example**" %}{.json-schema-example}

```json translate=no
{
  "type": "CATEGORY",
  "id": "019b21d9-c5d9-777d-80bd-d67c664bc6d9"
}
```

{% endcut %}

</div>

<div class="openapi-entity">

### BlogStatus {#entity-BlogStatus}

Статус публикации новости.

**Type**: string

_Enum:_{.json-schema-reset .json-schema-value} `ACTIVE`, `INACTIVE`

</div>

## Responses

<div class="openapi__response__code__201">

## 201 Created

Новость создана.

<div class="openapi-entity">

### Body

{% cut "application/json" %}

```json translate=no
{
  "id": "019b21d9-c5d9-777d-80bd-d67c664bc6d9",
  "slug": "example",
  "title": "example",
  "short_description": "example",
  "is_short_description_auto_generated": true,
  "content": "example",
  "blog_dates": {
    "start_date": "2025-01-01T00:00:00Z",
    "end_date": "2025-01-01T00:00:00Z"
  },
  "tags": [
    "example"
  ],
  "seo_title": "example",
  "seo_h1": "example",
  "seo_description": "example",
  "desktop_media": [
    {
      "type": "IMAGE",
      "display_sequence": 1,
      "image_id": "019b30d4-3e28-7a98-ae46-cb66932d1936",
      "video_id": "vplvusemmooxmhpwiqli"
    }
  ],
  "mobile_media": [
    null
  ],
  "preview_media": [
    null
  ],
  "attachment": {
    "type": "CATEGORY",
    "id": "019b21d9-c5d9-777d-80bd-d67c664bc6d9"
  },
  "status": "ACTIVE"
}
```

{% endcut %}

#|
|| **Name** | **Description** ||
||

_blog_dates_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: [BlogDates](#entity-BlogDates)

Даты действия новости.

{% cut "**Example**" %}{.json-schema-example}

```json translate=no
{
  "start_date": "2025-01-01T00:00:00Z",
  "end_date": "2025-01-01T00:00:00Z"
}
```

{% endcut %}
{.table-cell}
||
||

_content_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

Содержимое новости.

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||

_id_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: [BlogID](#entity-BlogID)

Идентификатор новости.

_Example:_{.json-schema-reset .json-schema-example} `019b21d9-c5d9-777d-80bd-d67c664bc6d9`
{.table-cell}
||
||

_seo_description_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

SEO описание новости.

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||

_seo_h1_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

SEO H1 новости.

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||

_seo_title_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

SEO заголовок новости.

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||

_slug_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

URL-идентификатор новости.

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||

_status_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: [BlogStatus](#entity-BlogStatus)

Статус новости.

Статус публикации новости.

_Enum:_{.json-schema-reset .json-schema-value} `ACTIVE`, `INACTIVE`
{.table-cell}
||
||

_tags_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string[]

Теги новости.

{% cut "**Example**" %}{.json-schema-example}

```json translate=no
[
  "example"
]
```

{% endcut %}
{.table-cell}
||
||

_title_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

Заголовок новости.

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||

_attachment_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: [BlogAttachment](#entity-BlogAttachment)

Связанная сущность.

{% cut "**Example**" %}{.json-schema-example}

```json translate=no
{
  "type": "CATEGORY",
  "id": "019b21d9-c5d9-777d-80bd-d67c664bc6d9"
}
```

{% endcut %}
{.table-cell}
||
||

_desktop_media_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: [VariantMedia](#entity-VariantMedia)[]

Медиа для отображения на версии для компьютера.

{% cut "**Example**" %}{.json-schema-example}

```json translate=no
[
  {
    "type": "IMAGE",
    "display_sequence": 1,
    "image_id": "019b30d4-3e28-7a98-ae46-cb66932d1936",
    "video_id": "vplvusemmooxmhpwiqli"
  }
]
```

{% endcut %}
{.table-cell}
||
||

_is_short_description_auto_generated_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: boolean

Флаг, указывающий, что краткое описание было сгенерировано автоматически.
{.table-cell}
||
||

_mobile_media_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: [VariantMedia](#entity-VariantMedia)[]

Медиа для отображения на мобильном устройстве.

{% cut "**Example**" %}{.json-schema-example}

```json translate=no
[
  {
    "type": "IMAGE",
    "display_sequence": 1,
    "image_id": "019b30d4-3e28-7a98-ae46-cb66932d1936",
    "video_id": "vplvusemmooxmhpwiqli"
  }
]
```

{% endcut %}
{.table-cell}
||
||

_preview_media_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: [VariantMedia](#entity-VariantMedia)[]

Медиа для отображения в превью.

{% cut "**Example**" %}{.json-schema-example}

```json translate=no
[
  {
    "type": "IMAGE",
    "display_sequence": 1,
    "image_id": "019b30d4-3e28-7a98-ae46-cb66932d1936",
    "video_id": "vplvusemmooxmhpwiqli"
  }
]
```

{% endcut %}
{.table-cell}
||
||

_short_description_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string

Краткое описание.

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
|#{.json-schema-properties}

</div>

<div class="openapi-entity">

### BlogID {#entity-BlogID}

Идентификатор новости.

**Type**: string&lt;uuid&gt;

_Example:_{.json-schema-reset .json-schema-example} `019b21d9-c5d9-777d-80bd-d67c664bc6d9`

</div>

</div>

<div class="openapi__response__code__400">

## 400 Bad Request

Некорректный запрос.

<div class="openapi-entity">

### Body

{% cut "application/json" %}

```json translate=no
{
  "code": "VALIDATION_ERROR",
  "message": "Invalid input",
  "trace_id": "00000000000000000000000000000000"
}
```

{% endcut %}

#|
|| **Name** | **Description** ||
||

_code_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

_Example:_{.json-schema-reset .json-schema-example} `VALIDATION_ERROR`
{.table-cell}
||
||

_message_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

_Example:_{.json-schema-reset .json-schema-example} `Invalid input`
{.table-cell}
||
||

_trace_id_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

Уникальный идентификатор запроса для отладки.

_Example:_{.json-schema-reset .json-schema-example} `00000000000000000000000000000000`
{.table-cell}
||
|#{.json-schema-properties}

</div>

</div>

<div class="openapi__response__code__401">

## 401 Unauthorized

Не авторизован.

<div class="openapi-entity">

### Body

{% cut "application/json" %}

```json translate=no
{
  "code": "VALIDATION_ERROR",
  "message": "Invalid input",
  "trace_id": "00000000000000000000000000000000"
}
```

{% endcut %}

#|
|| **Name** | **Description** ||
||

_code_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

_Example:_{.json-schema-reset .json-schema-example} `VALIDATION_ERROR`
{.table-cell}
||
||

_message_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

_Example:_{.json-schema-reset .json-schema-example} `Invalid input`
{.table-cell}
||
||

_trace_id_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

Уникальный идентификатор запроса для отладки.

_Example:_{.json-schema-reset .json-schema-example} `00000000000000000000000000000000`
{.table-cell}
||
|#{.json-schema-properties}

</div>

</div>

<div class="openapi__response__code__404">

## 404 Not Found

Ресурс не найден.

<div class="openapi-entity">

### Body

{% cut "application/json" %}

```json translate=no
{
  "code": "VALIDATION_ERROR",
  "message": "Invalid input",
  "trace_id": "00000000000000000000000000000000"
}
```

{% endcut %}

#|
|| **Name** | **Description** ||
||

_code_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

_Example:_{.json-schema-reset .json-schema-example} `VALIDATION_ERROR`
{.table-cell}
||
||

_message_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

_Example:_{.json-schema-reset .json-schema-example} `Invalid input`
{.table-cell}
||
||

_trace_id_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

Уникальный идентификатор запроса для отладки.

_Example:_{.json-schema-reset .json-schema-example} `00000000000000000000000000000000`
{.table-cell}
||
|#{.json-schema-properties}

</div>

</div>

<div class="openapi__response__code__500">

## 500 Internal Server Error

Внутренняя ошибка сервера.

<div class="openapi-entity">

### Body

{% cut "application/json" %}

```json translate=no
{
  "code": "VALIDATION_ERROR",
  "message": "Invalid input",
  "trace_id": "00000000000000000000000000000000"
}
```

{% endcut %}

#|
|| **Name** | **Description** ||
||

_code_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

_Example:_{.json-schema-reset .json-schema-example} `VALIDATION_ERROR`
{.table-cell}
||
||

_message_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

_Example:_{.json-schema-reset .json-schema-example} `Invalid input`
{.table-cell}
||
||

_trace_id_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

Уникальный идентификатор запроса для отладки.

_Example:_{.json-schema-reset .json-schema-example} `00000000000000000000000000000000`
{.table-cell}
||
|#{.json-schema-properties}

</div>

</div>

</div>

[*Deprecated]: No longer supported, please use an alternative and newer version.