diff --git a/public/openapi/read/recent/posts/term.yaml b/public/openapi/read/recent/posts/term.yaml
index 3a3bcfa7b4..6076358742 100644
--- a/public/openapi/read/recent/posts/term.yaml
+++ b/public/openapi/read/recent/posts/term.yaml
@@ -8,7 +8,8 @@ get:
       required: true
       schema:
         type: string
-      example: day, week, month. If not passed the latest posts will be returned without limiting by date.
+      example: /api/recent/posts/day
+      description: term is used to limit the returned posts to a specific term. Valid values are day, week, month. If you don't pass it in all posts will be returned.
     - name: page
       in: query
       required: false