diff --git a/docs/samples/sample_roles.json.md b/docs/samples/sample_roles.json.md
new file mode 100644
index 000000000..035510f22
--- /dev/null
+++ b/docs/samples/sample_roles.json.md
@@ -0,0 +1,28 @@
+### roles
+
+`/api/roles/`
+
+```json
+[
+    {
+        'id': 1, 
+        'name': 'Observateur', 
+        'permissions': ['ScoObservateur'
+        ]
+    },
+    {
+        'id': 2,
+        'name': 'Ens',
+        'permissions': [
+            'ScoEntrepriseView',
+            'ScoEtudAddAnnotations',
+            'ScoAbsAddBillet',
+            'ScoAbsChange',
+            'ScoUsersView',
+            'ScoObservateur',
+            'ScoEnsView',
+            'ScoView'
+        ]
+    }
+]
+```