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

Delete a folder

Request

You can delete a folder (if it contains no content) by making a DELETE 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:"2.17"
Enum:"1.0""1.1""1.2""1.3""1.4""2.0""2.1""2.2""2.3""2.4"
Example:2.17
curl -i -X DELETE \
  https://api.intercom.io/folders/6 \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Intercom-Version: 2.17'

Responses

folder deleted

Bodyapplication/json
idstring

The unique identifier for the deleted folder

Example:"6"
objectstring

The type of object - folder.

Value:"folder"
Example:"folder"
deletedboolean

Whether the folder was successfully deleted.

Example:true
Response
{
  "id": "6",
  "object": "folder",
  "deleted": true
}