Skip to content

Commit 6b44930

Browse files
markdennis22claude
andcommitted
Add article tags limitation callout to createArticle and updateArticle
Tags cannot be managed via the Articles API, but this wasn't documented on the create/update endpoints. Adds the same callout format used by listArticles to prevent confusion when developers attempt to set tags. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
1 parent 66fb630 commit 6b44930

2 files changed

Lines changed: 22 additions & 6 deletions

File tree

descriptions/2.14/api.intercom.io.yaml

Lines changed: 11 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1041,7 +1041,11 @@ paths:
10411041
tags:
10421042
- Articles
10431043
operationId: createArticle
1044-
description: You can create a new article by making a POST request to `https://api.intercom.io/articles`.
1044+
description: "You can create a new article by making a POST request to `https://api.intercom.io/articles`.\n\n>
1045+
\U0001F4D8 Tags cannot be managed via the Articles API\n>\n> While article tags are
1046+
returned in API responses, you cannot create, update, or delete tags through
1047+
the `/articles` endpoints. To manage article tags, use the Intercom UI or
1048+
the dedicated Tags API endpoints.\n"
10451049
responses:
10461050
'200':
10471051
description: article created
@@ -1236,8 +1240,12 @@ paths:
12361240
tags:
12371241
- Articles
12381242
operationId: updateArticle
1239-
description: You can update the details of a single article by making a PUT
1240-
request to `https://api.intercom.io/articles/<id>`.
1243+
description: "You can update the details of a single article by making a PUT
1244+
request to `https://api.intercom.io/articles/<id>`.\n\n> \U0001F4D8 Tags cannot be
1245+
managed via the Articles API\n>\n> While article tags are returned in API
1246+
responses, you cannot create, update, or delete tags through the `/articles`
1247+
endpoints. To manage article tags, use the Intercom UI or the dedicated Tags
1248+
API endpoints.\n"
12411249
responses:
12421250
'200':
12431251
description: successful

descriptions/2.15/api.intercom.io.yaml

Lines changed: 11 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1041,7 +1041,11 @@ paths:
10411041
tags:
10421042
- Articles
10431043
operationId: createArticle
1044-
description: You can create a new article by making a POST request to `https://api.intercom.io/articles`.
1044+
description: "You can create a new article by making a POST request to `https://api.intercom.io/articles`.\n\n>
1045+
\U0001F4D8 Tags cannot be managed via the Articles API\n>\n> While article tags are
1046+
returned in API responses, you cannot create, update, or delete tags through
1047+
the `/articles` endpoints. To manage article tags, use the Intercom UI or
1048+
the dedicated Tags API endpoints.\n"
10451049
responses:
10461050
'200':
10471051
description: article created
@@ -1236,8 +1240,12 @@ paths:
12361240
tags:
12371241
- Articles
12381242
operationId: updateArticle
1239-
description: You can update the details of a single article by making a PUT
1240-
request to `https://api.intercom.io/articles/<id>`.
1243+
description: "You can update the details of a single article by making a PUT
1244+
request to `https://api.intercom.io/articles/<id>`.\n\n> \U0001F4D8 Tags cannot be
1245+
managed via the Articles API\n>\n> While article tags are returned in API
1246+
responses, you cannot create, update, or delete tags through the `/articles`
1247+
endpoints. To manage article tags, use the Intercom UI or the dedicated Tags
1248+
API endpoints.\n"
12411249
responses:
12421250
'200':
12431251
description: successful

0 commit comments

Comments
 (0)