diff --git a/static/openapi-spec/categories-v1.yaml b/static/openapi-spec/categories-v1.yaml
index 1b4b5f2041d..4380987d441 100644
--- a/static/openapi-spec/categories-v1.yaml
+++ b/static/openapi-spec/categories-v1.yaml
@@ -34,9 +34,9 @@ paths:
           schema:
             type: integer
             minimum: 1
-            maximum: 100
-            default: 5
-          description: Maximum number of items to return
+            maximum: 11
+            default: 11
+          description: The maximum number of items to be returned per request. The default and maximum value is 11. A limit of 0 implies a use of the default limit.
         - name: offset
           in: query
           required: false
@@ -44,7 +44,7 @@ paths:
             type: integer
             minimum: 0
             default: 0
-          description: Number of items to skip before starting to collect the result set
+          description: Number of items to skip before starting to collect the result set.
       responses:
         '200':
           description: List of categories
@@ -598,4 +598,4 @@ components:
                   code:
                     type: integer
                     description: 'HTTP status code'
-                    default: 500
\ No newline at end of file
+                    default: 500