Organiser un coffre en dossiers
Créez une arborescence de dossiers dans un coffre, renommez-les, rangez-y des documents et supprimez les dossiers vides.
- Required access
- Rôle HDS_HEALTHCARE, HDS_STORAGE ou HDS_ADMIN
- Duration
- 10 min
This page has not been translated yet and is shown in French.
Les dossiers rangent les documents d'un coffre, à la manière d'un classeur : « Comptes rendus », « Imagerie », « Ordonnances ». Un dossier peut contenir des sous-dossiers.
Avant de commencer
- Un coffre existant, non supprimé. Voir Gérer les coffres.
- Pour lire les dossiers, tout rôle HDS sauf
HDS_DELETEseul ; pour les créer, renommer ou y ranger des documents,HDS_HEALTHCARE,HDS_STORAGEouHDS_ADMIN; pour les supprimer,HDS_DELETEouHDS_ADMIN.
Créer un dossier
curl -X POST "https://api.wakastart.app/api/hds/vaults/vlt_a1B2c3D4/folders" \
-H "Authorization: Bearer $USER_TOKEN" \
-H "Content-Type: application/json" \
-d '{ "name": "Imagerie" }'Réponse attendue (201 Created) :
{
"folderId": "fld_Hb5Tn1Yc",
"vaultId": "vlt_a1B2c3D4",
"parentFolderId": null,
"name": "Imagerie",
"sortOrder": 0,
"createdBy": "8f14e45f-ceea-467f-a0e6-2d2d3a7c1b11",
"createdAt": "2026-10-23T11:02:10.004Z",
"updatedAt": "2026-10-23T11:02:10.004Z"
}Pour un sous-dossier, ajoutez "parentFolderId": "fld_Hb5Tn1Yc". Le nom fait 255 caractères au plus.
Lister les dossiers
curl "https://api.wakastart.app/api/hds/vaults/vlt_a1B2c3D4/folders?parentFolderId=fld_Hb5Tn1Yc" \
-H "Authorization: Bearer $USER_TOKEN"La réponse est un tableau de dossiers, triés par sortOrder puis par date de création. Sans parentFolderId, tous les dossiers du coffre sont listés ; avec une valeur vide, seuls ceux de la racine.
Renommer ou réordonner un dossier
curl -X PATCH "https://api.wakastart.app/api/hds/vaults/vlt_a1B2c3D4/folders/fld_Hb5Tn1Yc" \
-H "Authorization: Bearer $USER_TOKEN" \
-H "Content-Type: application/json" \
-d '{ "name": "Imagerie médicale", "sortOrder": 1 }'Ranger un document dans un dossier
Indiquez le document et le dossier cible dans le corps. targetFolderId absent ou vide replace le document à la racine.
curl -X POST "https://api.wakastart.app/api/hds/vaults/vlt_a1B2c3D4/folders/fld_Hb5Tn1Yc/move-document" \
-H "Authorization: Bearer $USER_TOKEN" \
-H "Content-Type: application/json" \
-d '{ "docId": "doc_Pz3Vb6Nc", "targetFolderId": "fld_Hb5Tn1Yc" }'Réponse attendue :
{ "moved": true, "docId": "doc_Pz3Vb6Nc", "targetFolderId": "fld_Hb5Tn1Yc" }Supprimer un dossier
curl -X DELETE "https://api.wakastart.app/api/hds/vaults/vlt_a1B2c3D4/folders/fld_Hb5Tn1Yc" \
-H "Authorization: Bearer $USER_TOKEN"Réponse attendue : { "deleted": true, "folderId": "fld_Hb5Tn1Yc" }. Le dossier doit être vide : sans sous-dossier ni document.
Vérifier le résultat
GET …/documents?folderId=fld_Hb5Tn1Ycliste le document rangé.- Le journal d'audit contient
FOLDER_CREATEDetDOCUMENT_MOVED.
Dépannage
400Cannot delete folder with 2 documents: déplacez ou supprimez d'abord les documents.400Cannot create folder in deleted vault: le coffre est supprimé.404Parent folder not found: …: le dossier parent n'appartient pas à ce coffre.