Add a tag to an article

Request

Apply an existing tag to an article. Returns the tag that was applied.

The tag must already exist in the workspace (create tags with the Tags API), and the authenticating teammate must have the manage_knowledge_base_content permission.

Requires the read_write_articles_scope OAuth scope. Set Intercom-Version: Preview.

Security

bearerAuth

Path

article_idintegerrequired

The unique identifier for the article which is given by Intercom.

Example:123

Headers

Intercom-Versionstring(intercom_version_preview)

Preview Intercom API version. Used for closed beta endpoints or other features under managed availability.

Default:"Preview"

Value:"Preview"

Example:Preview

Bodyapplication/json

idstringrequired

The unique identifier of the tag to apply, as given by Intercom.

Example:"7522907"

admin_idstring or null

Optional id of the teammate to attribute the tagging to. Defaults to the authenticating teammate. Does not affect authorization.

Example:"1234"

curl -i -X POST \
  https://api.intercom.io/articles/123/tags \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -H 'Intercom-Version: Preview' \
  -d '{
    "id": "7522907"
  }'

Responses

Tag applied

Bodyapplication/json

typestring

value is "tag"

Example:"tag"

idstring

The id of the tag

Example:"123456"

namestring

The name of the tag

Example:"Test tag"

applied_atinteger or null, (date-time)

The time when the tag was applied to the object. Only present when the tag is returned as part of a tagging operation on a contact, conversation, ticket, article, internal article, or content snippet.

Example:1663597223

applied_byobject or null(Reference)

The admin who applied the tag. Only present when the tag is returned as part of a tagging operation on a contact, conversation, ticket, article, internal article, or content snippet.

Response

{
  "type": "tag",
  "id": "7522907",
  "name": "Independent",
  "applied_at": 1663597223,
  "applied_by": {
    "type": "admin",
    "id": "1234"
  }
}