diff --git a/core/openapi.md b/core/openapi.md
index 7b310b9ea1f..8de15d661f7 100644
--- a/core/openapi.md
+++ b/core/openapi.md
@@ -393,7 +393,27 @@ use App\Controller\RandomRabbit;
                     ]
                 ]
             ])
-        )
+        ),
+        responses: [
+            201 => new Model\Response(
+                content: new \ArrayObject([
+                        'application/json' => [
+                            'schema' => [
+                                'type' => 'object',
+                                'properties' => [
+                                    'status' => ['type' => 'string'],
+                                    'description' => ['type' => 'string']
+                                ]
+                            ],
+                            'example' => [
+                                'status' => 'success',
+                                'description' => 'Rabbit picture created.',
+                            ]
+                        ]
+                    ]
+                )
+            )
+        ],
     )
 )]
 class Rabbit