diff --git a/descriptions/0/api.intercom.io.yaml b/descriptions/0/api.intercom.io.yaml index 56bb766e..0f3d961f 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 9899675f..a7992a74 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 7fe9f8c1..bd186a4d 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 70aac5aa..4d5d89ce 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 d2255784..d9813bb4 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 2b224f0f..c829dd8e 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 49ae729c..6a95759d 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 5b27176d..afd781b6 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 19ea31b9..8d76a572 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 d8f84eda..2934e9d2 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 c8e73661..26c49ea0 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