The description of the article. For multilingual articles, this will be the description of the default language's content.

The content of the article in HTML. For multilingual articles, this will be the body of the default language's content. Mutually exclusive with body_markdown.

The content of the article in markdown. For multilingual articles, this will be the body of the default language's content. An alternative to body — you can provide content as markdown instead of HTML. Mutually exclusive with body.

The id of the author of the article. For multilingual articles, this will be the id of the author of the default language's content. Must be a teammate on the help center's workspace. Required unless an author_id is provided in translated_content under the workspace's default Help Center locale.

Whether the article will be published or will be a draft. Defaults to draft. For multilingual articles, this will be the state of the default language's content.

The id of the article's parent collection or section. An article without this field stands alone.

The ids of the parent collections to place this article in. Send an empty array to leave the article without a collection. When provided, this takes precedence over parent_id.

The locale of the article's default content, for example en. Defaults to the locale of the help center that the parent collection belongs to when parent_id is sent, and otherwise to the default Help Center locale. Must be a locale supported by the workspace's Help Center.

Content for other locales, keyed by locale code. Content for the article's default locale can also be given here instead of at the top level. If it is given in both places, the values must match.

The ID of the folder to place this article in, or null to leave it without a folder.

The list of audience IDs to assign to this article for Fin AI Agent targeting. Sending a top-level audience_ids broadcasts the same set to every locale. For per-locale targeting, use translated_content.<locale>.audience_ids instead. Sending both top-level and per-locale in the same request causes top-level to win. Unknown audience IDs return a 404 error. No partial commit occurs.

Whether the article should be available for AI Chatbot (Fin). For multilingual articles, this sets the default language's availability.

Whether the article should be available for AI Copilot. For multilingual articles, this sets the default language's availability.

Whether the article should be available for AI Sales Agent. For multilingual articles, this sets the default language's availability.

ISO 8601 timestamp at which to schedule a future publish of the article. When set together with state: "published", the article is scheduled instead of published immediately. Setting null cancels a pending publish schedule. Timestamps in the past or equal to the current time are rejected with 400 parameter_invalid — the value must be strictly in the future. Combining with state: "draft" returns 400 parameter_invalid. Sending in the same request as scheduled_unpublish_at returns 400 — only one pending schedule per article. Empty string returns 400 parameter_invalid.

ISO 8601 timestamp at which to schedule a future unpublish of the article. The same request must also publish the article (state: "published"), otherwise it returns 400 parameter_invalid. The value must be strictly in the future; timestamps in the past or equal to the current time are rejected with 400 parameter_invalid. Setting null cancels a pending unpublish schedule. Sending in the same request as scheduled_publish_at returns 400 — only one pending schedule per article. Empty string returns 400 parameter_invalid.