Skip to content
Home/
REST API Reference
/
/
Update a folder

Update a folder

Request

You can update a folder by making a PUT request to https://api.intercom.io/folders/<id>.

Security
bearerAuth
Path
idintegerrequired

The unique identifier for the folder

Example:6
Headers
Intercom-Versionstring(intercom_version)

Intercom API version.
By default, it's equal to the version set in the app package.

Default:"Preview"
Enum:"1.0""1.1""1.2""1.3""1.4""2.0""2.1""2.2""2.3""2.4"
Example:Preview
Bodyapplication/json
folderobjectrequired
curl -i -X PUT \
  https://api.intercom.io/folders/6 \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -H 'Intercom-Version: Preview' \
  -d '{
    "folder": {
      "name": "Updated Product Documentation",
      "emoji": "📖"
    }
  }'

Responses

folder updated

Bodyapplication/json
idinteger

The unique identifier for the folder

Example:6
namestring

The name of the folder

Example:"Product Documentation"
descriptionstring or null

The description of the folder

Example:"Internal product documentation"
emojistring or null

An emoji associated with the folder

Example:"📚"
parent_folder_idinteger or null

The ID of the parent folder, or null if this is a root folder

Example:null
content_countinteger

The number of content items in this folder

Example:5
created_atinteger, (date-time)

The time when the folder was created (seconds)

Example:1672928359
updated_atinteger, (date-time)

The time when the folder was last updated (seconds)

Example:1672928610
Response
{
  "id": 6,
  "name": "Updated Product Documentation",
  "description": "Internal product docs",
  "emoji": "📖",
  "parent_folder_id": null,
  "content_count": 5,
  "created_at": 1672928359,
  "updated_at": 1672928900
}