diff --git a/docs/api/cases/cases-api-get-case.asciidoc b/docs/api/cases/cases-api-get-case.asciidoc
index 468bfa095b7c5..4419eb5e09501 100644
--- a/docs/api/cases/cases-api-get-case.asciidoc
+++ b/docs/api/cases/cases-api-get-case.asciidoc
@@ -35,7 +35,7 @@ default space is used.
 (Optional, boolean) Determines whether case comments are returned. Defaults to 
 `true`.
 
-deprecated:[8.1.0]
+deprecated:[8.1.0, "The `includeComments` query parameter is deprecated and will be removed in a future release."]
 
 ==== Response code