Basic

Retrieve folder

Retrieve folder metadata by its ID.

get/files/2026-09-beta/folders/{folderId}

Path parameters

folderIdstring required

The ID of the folder to retrieve.

Query parameters

propertiesstring[]

A comma-separated list of folder property names to include in the response.

Response

successful operation

archivedboolean required

A boolean indicating whether the folder is archived.

archivedAtstring date-time

The date and time when the folder was archived, in ISO 8601 format.

createdAtstring date-time required

The date and time when the folder was created, in ISO 8601 format.

idstring required

The unique ID for the folder, represented as a string.

namestring

The name of the folder, represented as a string.

parentFolderIdstring

The unique identifier of the parent folder, represented as a string.

pathstring

The path of the folder within the file system, represented as a string.

updatedAtstring date-time required

The date and time when the folder was last updated, in ISO 8601 format.