Skip to content

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.

GuideDeveloper
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_DELETE seul ; pour les créer, renommer ou y ranger des documents, HDS_HEALTHCARE, HDS_STORAGE ou HDS_ADMIN ; pour les supprimer, HDS_DELETE ou HDS_ADMIN.

Créer un dossier

Bash
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) :

JSON
{
  "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

Bash
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

Bash
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.

Bash
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 :

JSON
{ "moved": true, "docId": "doc_Pz3Vb6Nc", "targetFolderId": "fld_Hb5Tn1Yc" }

Supprimer un dossier

Bash
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_Hb5Tn1Yc liste le document rangé.
  • Le journal d'audit contient FOLDER_CREATED et DOCUMENT_MOVED.

Dépannage

  • 400 Cannot delete folder with 2 documents : déplacez ou supprimez d'abord les documents.
  • 400 Cannot create folder in deleted vault : le coffre est supprimé.
  • 404 Parent folder not found: … : le dossier parent n'appartient pas à ce coffre.

Voir aussi