---
title: "Bulk importing articles, updating existing ones if they share the same ID."
method: POST
path: "/v1/helpcenter/articles/insertorupdatebulk"
tags: ["HelpCenter"]
---

# Bulk importing articles, updating existing ones if they share the same ID.

`POST /v1/helpcenter/articles/insertorupdatebulk`

## Request body

- HelpdeskArticle[]
  - `_id` integer, nullable
  - `title` string, nullable
  - `spoiler` string, nullable — Spoiler displayed under the title
  - `language` string, nullable — 2-letter language code
  - `body` string, nullable — Body of the article in Markdown format
  - `user` HelpdeskArticleUser, required
    - `name` string, nullable — Name of the user
    - `email` string, nullable — email of the user
    - `avatarUrl` string, nullable — Avatar URL of the user
  - `isDraft` boolean, nullable — Whether this is a draft article
  - `slug` string, nullable — Auto-generated URL slug of the article, e.g. infoset.help/acmeinc/articles/{id}-{slug}
  - `rates` HelpdeskArticleRate[], nullable
    - `visitor` unknown
    - `rate` number, double, nullable — Rate, one of -1, 0, 1
    - `createdAt` unknown
    - `updatedAt` unknown
  - `stats` ArticleStats
    - `views` integer, nullable — Number of views
  - `desk` string, required — ID of the help center of this article
  - `departmentId` integer, nullable
  - `previous` HelpdeskArticle — recursive
  - `collection` integer, nullable — ID of the collection of this article
  - `createdAt` unknown
  - `updatedAt` unknown

## Response `201`

Created

- InsertBulkResponse
  - `inserted` integer
  - `updated` integer
  - `errors` InsertBulkError[], nullable
    - `row` integer — Starts from 0, the index of the element in the list that caused the error
    - `error` string, nullable — Error message

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.dev/infoset/apis/infoset-rest-api.md) · [All operations](https://skmtc.dev/infoset/apis/infoset-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/infoset/infoset-rest-api/revisions/f5bc39a1ac15/schema)