diff --git a/backend/src/main/java/org/raddatz/familienarchiv/geschichte/GeschichteController.java b/backend/src/main/java/org/raddatz/familienarchiv/geschichte/GeschichteController.java
index 8113238c..b675a2b5 100644
--- a/backend/src/main/java/org/raddatz/familienarchiv/geschichte/GeschichteController.java
+++ b/backend/src/main/java/org/raddatz/familienarchiv/geschichte/GeschichteController.java
@@ -102,6 +102,10 @@ public class GeschichteController {
 
     @PutMapping("/{id}/items/reorder")
     @RequirePermission(Permission.BLOG_WRITE)
+    @Operation(
+        summary = "Reorder journey items",
+        description = "itemIds must contain ALL item IDs for the given journey in the desired new order. Sending a partial list returns 400 Bad Request."
+    )
     public List<JourneyItemView> reorderItems(
             @PathVariable UUID id,
             @RequestBody JourneyReorderDTO dto) {