API ReferenceBuilding AppsInstalling IntercomAPI & Webhook ReferenceCanvas Kit Reference
DocsApp StoreForumBlogYour Apps

Update a collection

Example Request & Response (Multilingual Help Center)

$ curl https://api.intercom.io/help_center/collection/<id> \
-X PUT \
-H 'Authorization:Bearer <Your access token>' \
-H 'Accept:application/json'
-H 'Content-Type: application/json' -d

{
  "name": "New title",
  "translated_content": {
    "es": {
      "name": "Nuevo título"
    }
  }
}
HTTP/1.1 200 OK
{
  "id": 1,
  "type": "collection",
  "workspace_id": "abcdef",
  "name": "New title",
  "description": "English description", 
  "created_at": 123456,
  "updated_at": 123456,
  "url": "http://intercom.test/help/collection/collection-1",
  "icon": "http://intercom/help_center/icon-1",
  "order": 0,
  "default_locale": "en",
  "translated_content": {
    "type": "group_translated_content",
    "es": {
      "type": "group_content",
      "name": "Nuevo título",
      "description": "Spanish description"
    }
  }
}

You can update the details of a single collection by making a PUT request to https://api.intercom.io/help_center/collection/<id>.

Request Path Parameters

ParameterTypeRequired?Description
idStringYesThe unique identifier for the collection which is given by Intercom.

Request Body Parameters

AttributeTypeRequired?Description
nameStringNoThe name of the collection.
For multilingual collections, this will be the name of the default language's content.
descriptionStringNoThe description of the collection.
For multilingual articles, this will be the description of the default language's content.
translated_contentObjectNoA Group Translated Content Object whereby you can specify multiple multilingual collections to be created.

Response

This will return a Collection Model of the collection you just updated.