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

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](/v1.0/hds/gerer-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

- [Déposer un document](/v1.0/hds/deposer-un-document)
- [Référence : objet dossier](/v1.0/hds/reference#dossier)
