diff --git a/descriptions/0/api.intercom.io.yaml b/descriptions/0/api.intercom.io.yaml index 56bb766..0f3d961 100644 --- a/descriptions/0/api.intercom.io.yaml +++ b/descriptions/0/api.intercom.io.yaml @@ -40087,8 +40087,12 @@ components: state: type: string description: 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. + 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. The `PUT /articles/{id}/draft` endpoint ignores + this field and always stages a draft. For multilingual articles, this + will be the state of the default language's content. enum: - published - draft diff --git a/descriptions/2.10/api.intercom.io.yaml b/descriptions/2.10/api.intercom.io.yaml index 9899675..a7992a7 100644 --- a/descriptions/2.10/api.intercom.io.yaml +++ b/descriptions/2.10/api.intercom.io.yaml @@ -16812,8 +16812,10 @@ components: state: type: string description: 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. + 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. For multilingual articles, this + will be the state of the default language's content. enum: - published - draft diff --git a/descriptions/2.11/api.intercom.io.yaml b/descriptions/2.11/api.intercom.io.yaml index 7fe9f8c..bd186a4 100644 --- a/descriptions/2.11/api.intercom.io.yaml +++ b/descriptions/2.11/api.intercom.io.yaml @@ -18661,8 +18661,10 @@ components: state: type: string description: 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. + 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. For multilingual articles, this + will be the state of the default language's content. enum: - published - draft diff --git a/descriptions/2.12/api.intercom.io.yaml b/descriptions/2.12/api.intercom.io.yaml index 70aac5a..4d5d89c 100644 --- a/descriptions/2.12/api.intercom.io.yaml +++ b/descriptions/2.12/api.intercom.io.yaml @@ -18323,8 +18323,10 @@ components: state: type: string description: 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. + 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. For multilingual articles, this + will be the state of the default language's content. enum: - published - draft diff --git a/descriptions/2.13/api.intercom.io.yaml b/descriptions/2.13/api.intercom.io.yaml index d225578..d9813bb 100644 --- a/descriptions/2.13/api.intercom.io.yaml +++ b/descriptions/2.13/api.intercom.io.yaml @@ -20011,8 +20011,10 @@ components: state: type: string description: 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. + 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. For multilingual articles, this + will be the state of the default language's content. enum: - published - draft diff --git a/descriptions/2.14/api.intercom.io.yaml b/descriptions/2.14/api.intercom.io.yaml index 2b224f0..c829dd8 100644 --- a/descriptions/2.14/api.intercom.io.yaml +++ b/descriptions/2.14/api.intercom.io.yaml @@ -22738,8 +22738,10 @@ components: state: type: string description: 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. + 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. For multilingual articles, this + will be the state of the default language's content. enum: - published - draft diff --git a/descriptions/2.15/api.intercom.io.yaml b/descriptions/2.15/api.intercom.io.yaml index 49ae729..6a95759 100644 --- a/descriptions/2.15/api.intercom.io.yaml +++ b/descriptions/2.15/api.intercom.io.yaml @@ -23746,8 +23746,10 @@ components: state: type: string description: 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. + 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. For multilingual articles, this + will be the state of the default language's content. enum: - published - draft diff --git a/descriptions/2.16/api.intercom.io.yaml b/descriptions/2.16/api.intercom.io.yaml index 5b27176..afd781b 100644 --- a/descriptions/2.16/api.intercom.io.yaml +++ b/descriptions/2.16/api.intercom.io.yaml @@ -34590,8 +34590,12 @@ components: state: type: string description: 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. + 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. The `PUT /articles/{id}/draft` endpoint ignores + this field and always stages a draft. For multilingual articles, this + will be the state of the default language's content. enum: - published - draft diff --git a/descriptions/2.7/api.intercom.io.yaml b/descriptions/2.7/api.intercom.io.yaml index 19ea31b..8d76a57 100644 --- a/descriptions/2.7/api.intercom.io.yaml +++ b/descriptions/2.7/api.intercom.io.yaml @@ -14273,8 +14273,10 @@ components: state: type: string description: 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. + 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. For multilingual articles, this + will be the state of the default language's content. enum: - published - draft diff --git a/descriptions/2.8/api.intercom.io.yaml b/descriptions/2.8/api.intercom.io.yaml index d8f84ed..2934e9d 100644 --- a/descriptions/2.8/api.intercom.io.yaml +++ b/descriptions/2.8/api.intercom.io.yaml @@ -14320,8 +14320,10 @@ components: state: type: string description: 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. + 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. For multilingual articles, this + will be the state of the default language's content. enum: - published - draft diff --git a/descriptions/2.9/api.intercom.io.yaml b/descriptions/2.9/api.intercom.io.yaml index c8e7366..26c49ea 100644 --- a/descriptions/2.9/api.intercom.io.yaml +++ b/descriptions/2.9/api.intercom.io.yaml @@ -16131,8 +16131,10 @@ components: state: type: string description: 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. + 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. For multilingual articles, this + will be the state of the default language's content. enum: - published - draft