Passer au contenu principal
GET
/
files
/
v3
/
folders
/
{folderPath}
Récupérer un dossier par un chemin
curl --request GET \
  --url https://api.hubapi.com/files/v3/folders/{folderPath} \
  --header 'Authorization: Bearer <token>'
{
  "archived": true,
  "createdAt": "2023-11-07T05:31:56Z",
  "id": "<string>",
  "updatedAt": "2023-11-07T05:31:56Z",
  "archivedAt": "2023-11-07T05:31:56Z",
  "name": "<string>",
  "parentFolderId": "<string>",
  "path": "<string>"
}

Produits pris en charge

Exige l'un des produits suivants ou un produit supérieur.
Marketing HubMarketing Hub -Gratuit
Sales HubSales Hub -Gratuit
Service HubService Hub -Gratuit
Content HubContent Hub -Gratuit
Cette API requiert l'une des portées suivantes :
files
files.ui_hidden.read

Autorisations

​
Authorization
string
header
requis

The access token received from the authorization server in the OAuth 2.0 flow.

Paramètres de chemin

​
folderPath
string
requis

Chemin du dossier souhaité.

Pattern: .+

Paramètres de requête

​
properties
string[]

Propriétés à définir sur le dossier retourné.

Réponse

successful operation

​
archived
boolean
requis

Indique si le dossier est supprimé ou non.

​
createdAt
string<date-time>
requis

Horodatage de la création du dossier.

​
id
string
requis

ID du dossier.

​
updatedAt
string<date-time>
requis

Horodatage de la dernière mise à jour du dossier.

​
archivedAt
string<date-time>

Horodatage de la suppression du dossier.

​
name
string

Nouveau nom. Si spécifié, le nom du dossier et fullPath changeront. Tous les dossiers enfants seront mis à jour en conséquence.

​
parentFolderId
string

Nouvel ID de dossier parent. S'il est modifié, le dossier et tous les dossiers enfants seront déplacés dans le dossier spécifié. parentFolderId et parentFolderPath ne peuvent pas être spécifiés en même temps

​
path
string

Chemin d'accès du dossier dans le gestionnaire de fichiers.

Last modified on February 12, 2026