diff --git a/docs/ScoDoc9API.md b/docs/ScoDoc9API.md
index 90c221eea..1c2543c21 100644
--- a/docs/ScoDoc9API.md
+++ b/docs/ScoDoc9API.md
@@ -1434,7 +1434,6 @@ valeurs numériques mais pas JSON compliant à cause des `NaN`.
 
 Cette API est disponible à partir de ScoDoc 9.6 et remplace les absences.
 
-<!-- TODO: faire les samples -->
 #### Structure Assiduité
 
 | attribut        | type           | commentaire                                                      |
@@ -1603,7 +1602,7 @@ Cette API est disponible à partir de ScoDoc 9.6 et remplace les absences.
 #### **assiduites-create**
 
 * **Méthode:** POST
-* **Permission: `ScoAssiduiteChange`**
+* **Permission: `ScoAbsChange`**
 * **Data:**
 
 ```json
@@ -1633,7 +1632,7 @@ Cette API est disponible à partir de ScoDoc 9.6 et remplace les absences.
 #### **assiduite-create**
 
 * **Méthode:** POST
-* **Permission: `ScoAssiduiteChange`**
+* **Permission: `ScoAbsChange`**
 * **Paramètres:** 
   * `etudid`
   * `nip`
@@ -1668,7 +1667,7 @@ Cette API est disponible à partir de ScoDoc 9.6 et remplace les absences.
 #### **assiduite-edit**
 
 * **Méthode:** POST
-* **Permission: `ScoAssiduiteChange`**
+* **Permission: `ScoAbsChange`**
 * **Paramètres:** `assiduite_id`
 * **Data:**
 
@@ -1693,7 +1692,7 @@ Cette API est disponible à partir de ScoDoc 9.6 et remplace les absences.
 #### **assiduites-edit**
 
 * **Méthode:** POST
-* **Permission: `ScoAssiduiteChange`**
+* **Permission: `ScoAbsChange`**
 * **Data:**
 
 ```json
@@ -1719,7 +1718,7 @@ Cette API est disponible à partir de ScoDoc 9.6 et remplace les absences.
 #### **assiduite-delete**
 
 * **Méthode:** POST
-* **Permission: `ScoAssiduiteChange`**
+* **Permission: `ScoAbsChange`**
 * **Data:**
 
 ```json
@@ -1793,7 +1792,7 @@ Cette API est disponible à partir de ScoDoc 9.6 et remplace les absences.
 #### **justificatif-create**
 
 * **Méthode:** POST
-* **Permission: `ScoJustifChange`**
+* **Permission: `ScoAbsChange`**
 * **Paramètres:** 
   * `etudid`
   * `nip`
@@ -1839,7 +1838,7 @@ Cette API est disponible à partir de ScoDoc 9.6 et remplace les absences.
 #### **justificatif-edit**
 
 * **Méthode:** POST
-* **Permission: `ScoJustifChange`**
+* **Permission: `ScoAbsChange`**
 * **Paramètres:** `justif_id`
 * **Data:**
 
@@ -1863,7 +1862,7 @@ Cette API est disponible à partir de ScoDoc 9.6 et remplace les absences.
 #### **justificatif-delete**
 
 * **Méthode:** POST
-* **Permission: `ScoJustifChange`**
+* **Permission: `ScoAbsChange`**
 * **Data:**
 
 ```json
@@ -1888,7 +1887,7 @@ Cette API est disponible à partir de ScoDoc 9.6 et remplace les absences.
 #### **justificatif-import**
 
 * **Méthode:** POST
-* **Permission: `ScoJustifChange`**
+* **Permission: `ScoAbsChange`**
 * **Paramètres:** `justif_id`
 
 > Procédure d'importation de fichier : [importer un justificatif](FichiersJustificatifs.md#importer-un-fichier)
@@ -1901,7 +1900,7 @@ Cette API est disponible à partir de ScoDoc 9.6 et remplace les absences.
 #### **justificatif-export**
 
 * **Méthode:** POST
-* **Permission: `ScoJustifChange`**
+* **Permission: `ScoAbsChange`**
 * **Paramètres:**
   * `justif_id`
   * `filename`
@@ -1916,7 +1915,7 @@ Cette API est disponible à partir de ScoDoc 9.6 et remplace les absences.
 #### **justificatif-remove**
 
 * **Méthode:** POST
-* **Permission: `ScoJustifChange`**
+* **Permission: `ScoAbsChange`**
 * **Paramètres:** `justif_id`
 
 > Procédure de suppression de fichier : [supprimer un justificatif](FichiersJustificatifs.md#supprimer-un-fichier)
diff --git a/docs/samples/sample_justificatif_export.json.md b/docs/samples/sample_justificatif_export.json.md
new file mode 100644
index 000000000..60af4a411
--- /dev/null
+++ b/docs/samples/sample_justificatif_export.json.md
@@ -0,0 +1,7 @@
+### justificatif_export
+
+#### POST /justificatif/1/export/nom_fichier
+
+```console
+téléchargement du fichier
+```
diff --git a/docs/samples/sample_justificatif_import.json.md b/docs/samples/sample_justificatif_import.json.md
new file mode 100644
index 000000000..4ce0df3e8
--- /dev/null
+++ b/docs/samples/sample_justificatif_import.json.md
@@ -0,0 +1,11 @@
+### justificatif_import
+
+#### POST /justificatif/1/import
+
+> `Content-Type: multipart/form-data`
+>
+> `binary file`
+
+```json
+{ "filename": "nom_du_fichier" }
+```
diff --git a/docs/samples/sample_justificatif_justifies.json.md b/docs/samples/sample_justificatif_justifies.json.md
new file mode 100644
index 000000000..716d71942
--- /dev/null
+++ b/docs/samples/sample_justificatif_justifies.json.md
@@ -0,0 +1,7 @@
+### justificatif_justifies
+
+#### GET /justificatif/1/justifies
+
+```json
+[1, 2, "..."]
+```
diff --git a/docs/samples/sample_justificatif_list.json.md b/docs/samples/sample_justificatif_list.json.md
new file mode 100644
index 000000000..31c24518c
--- /dev/null
+++ b/docs/samples/sample_justificatif_list.json.md
@@ -0,0 +1,10 @@
+### justificatif_list
+
+#### GET /justificatif/1/list
+
+```json
+{
+  "total": 1,
+  "filenames": ["nom_fichier"]
+}
+```
diff --git a/docs/samples/sample_justificatif_remove.json.md b/docs/samples/sample_justificatif_remove.json.md
new file mode 100644
index 000000000..3caff4119
--- /dev/null
+++ b/docs/samples/sample_justificatif_remove.json.md
@@ -0,0 +1,25 @@
+### justificatif_remove
+
+#### POST /justificatif/1/remove
+
+> `Content-Type: application/json`
+>
+> `{"remove" : "all"}`
+
+```json
+{
+  "response": "remove"
+}
+```
+
+#### POST /justificatif/1/remove
+
+> `Content-Type: application/json`
+>
+> `{"remove" : "list", "filenames": ["nom_fichier"]}`
+
+```json
+{
+  "response": "remove"
+}
+```