> ## Documentation Index
> Fetch the complete documentation index at: https://developers.redo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# helpCenterArticleUpdate

> Change a help center article, as saving it in the dashboard's editor does: its title, body, published state or collection. Agent knowledge linked to it follows: an unpublished article is unlinked, a moved one is repointed, and any other is refreshed. Null when the store has no article with this id. The write is saved at once; the returned object is read from the help center's read copy, which can show the previous values for a moment after the write.

**Required scopes:** [`support_help_center_write`](https://developers.redo.com/docs/api-reference/v3/reference/scopes#scope-support_help_center_write)

## Arguments

**id** `ID!` *required*

The m\_hca\_… id.

**input** `[HelpCenterArticleUpdateInput!](/docs/api-reference/v3/reference/support/help-center-article-update-input)` *required*

**fields**

**collection** `ID`

Moves the article to the end of this collection (m\_hcc\_…), out of the one it was in. Must be one of the store's collections; otherwise NOT\_FOUND.

**html** `String`

The body as HTML, as the dashboard's editor saves it. At most 2,000,000 characters; otherwise BAD\_USER\_INPUT.

**published** `Boolean`

Unpublishing the article removes the agent knowledge linked to it; publishing it again doesn't restore that.

**title** `String`

Can't be blank (spaces alone count as blank) or longer than 255 characters; otherwise BAD\_USER\_INPUT.

## Returns

**helpCenterArticleUpdate** `[HelpCenterArticle](/docs/api-reference/v3/reference/support/help-center-article)`

A help center article.

**fields**

**collections** `[\[HelpCenterCollectionSummary!\]!](/docs/api-reference/v3/reference/support/help-center-collection-summary)` *required*

The collections that list the article, by title, each once. These are the collections shoppers find it under and whose `articles` include it. Empty when none lists it.

**Requires:** [`support_config_read`](https://developers.redo.com/docs/api-reference/v3/reference/scopes#scope-support_config_read)

**fields**

**description** `String!` *required*

The collection's description. Empty when none is set.

**id** `ID!` *required*

m\_hcc\_… id, the collection id in the dashboard.

**published** `Boolean!` *required*

Whether the collection itself is published.

**title** `String!` *required*

The collection's title.

**visibleToShoppers** `Boolean!` *required*

Whether shoppers see the collection: the store's help desk is on, the collection is published, a published page lists it, and it lists at least one published article.

**html** `String!` *required*

The article body as HTML, as saved in the dashboard's editor. Shoppers see it sanitized. Empty when none is saved.

**id** `ID!` *required*

m\_hca\_… id, the article id in the dashboard and in agent knowledge.

**lastEditedAt** `[DateTime](/docs/api-reference/v3/reference/common/date-time)`

When the article was last saved (the dashboard's Last updated). Null for an article never saved since that was recorded.

**published** `Boolean!` *required*

Whether the article itself is published (Published, not Draft, in the dashboard).

**title** `String!` *required*

The article's title. Empty when none is set.

**visibleToShoppers** `Boolean!` *required*

Whether shoppers see the article: it is published and listed by a collection shoppers see (`HelpCenterCollection.visibleToShoppers`).

## Errors

Besides the [errors any request can return](https://developers.redo.com/docs/api-reference/v3/errors.md), this operation fails with these codes in `extensions.code`.

| Code | HTTP status | Meaning | Retry |
| - | - | - | - |
| `API_TOKEN_REQUIRED` | `403` | The credential has no API token to attribute the change to, such as a first-party token. Nothing was sent. | Call with a store API token. |
| `BAD_USER_INPUT` | `400` | An argument is invalid, or names something the store doesn't have. The message says which. Nothing was written. | Fix the input the message names, then send it again. |
| `NOT_FOUND` | `404` | An id the request refers to, other than its target, doesn't exist in the store. A missing target returns null instead. | Use an id that exists in the store. |
| `INTERNAL_SERVER_ERROR` | `500` | Something failed on Redo's side. The change may or may not have been made. | Read the record to see whether the change was made before sending it again. A send with an idempotencyKey is safe to retry with the same key. |

## Example

```graphql theme={null}
mutation {
  helpCenterArticleUpdate(id: "...", input: { ... }) {
    html
    id
    lastEditedAt
    published
    title
    visibleToShoppers
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.