diff --git a/doc/api/tags.md b/doc/api/tags.md
index 4af096c3c0cb5ffae7672d88da423157d97b7c11..f2a3f9f28d20b6c44cb3e222d2feadf003fd97d6 100644
--- a/doc/api/tags.md
+++ b/doc/api/tags.md
@@ -174,8 +174,19 @@ Parameters:
 
 - `id` (required) - The ID or [URL-encoded path of the project](README.md#namespaced-path-encoding) owned by the authenticated user
 - `tag_name` (required) - The name of a tag
+
+Request body:
+
 - `description` (required) - Release notes with markdown support
 
+```json
+{
+  "description": "Amazing release. Wow"
+}
+```
+
+Response:
+
 ```json
 {
   "tag_name": "1.0.0",
@@ -195,8 +206,19 @@ Parameters:
 
 - `id` (required) - The ID or [URL-encoded path of the project](README.md#namespaced-path-encoding) owned by the authenticated user
 - `tag_name` (required) - The name of a tag
+
+Request body:
+
 - `description` (required) - Release notes with markdown support
 
+```json
+{
+  "description": "Amazing release. Wow"
+}
+```
+
+Response:
+
 ```json
 {
   "tag_name": "1.0.0",