GET
/folders/{id}Retrieve a folder
Retrieves a folder by its unique identifier. Use the id path parameter to select the folder whose details you need.
idintegerrequired
The unique identifier of the folder to retrieve.
Intercom-Versionstringoptional
Selects the API version. Defaults to `2.17` when omitted; supported versions include 1.0 through 1.4 and 2.0 through 2.6.
200Returns the folder object, including its name, description, emoji, parent folder ID, content count, and creation and update timestamps.
idintegeroptional
The unique identifier for the folder
namestringoptional
The name of the folder
descriptionstringoptional
The description of the folder
emojistringoptional
An emoji associated with the folder
parent_folder_idintegeroptional
The ID of the parent folder, or null if this is a root folder
content_countintegeroptional
The number of content items in this folder
created_atintegeroptional
The time when the folder was created (seconds)
updated_atintegeroptional
The time when the folder was last updated (seconds)
401Returned when the request is unauthorized.
typestringrequired
The type is error.list
request_idstringoptional
errorsarray<object>required
An array of one or more error objects
404Returned when the folder does not exist.
typestringrequired
The type is error.list
request_idstringoptional
errorsarray<object>required
An array of one or more error objects
Error handling
A 401 is returned when the request is unauthorized. A 404 is returned when the id path parameter does not identify an existing folder.