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.

Whether the article will be published or will be a draft. Omitting this field leaves the publish state unchanged, so a draft stays a draft and an edit to a published article goes live immediately unless that article already has a pending draft or a scheduled publish time is set in the same request. For multilingual articles, this will be the state of the default language's content.

The id of the collection or section to move the article into. Omitting this field or sending null leaves the article's parent unchanged. Send home to remove the article from its collection so that it stands alone.

The ids of the parent collections to place this article in. Send an empty array to remove the article from all collections. When provided, this takes precedence over parent_id.

The Translated Content of an Article. The keys are the locale codes and the values are the translated content of the article.

The ID of the folder to place this article in, or null to remove it from its 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. Sending audience_ids: [] clears all audience memberships from 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 article must already be published; setting state: "published" in the same request does not count, and the request returns 400 parameter_invalid. Combining with state: "draft" also 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.