diff --git a/spec/openapi.yaml b/spec/openapi.yaml
index a7464b6a..e35923a6 100644
--- a/spec/openapi.yaml
+++ b/spec/openapi.yaml
@@ -5597,7 +5597,7 @@ paths:
   '/jobs-api/v3/accounts/{accountUid}/jobs':
     get:
       summary: List jobs within an account
-      description: List / search the jobs within an account.
+      description: List / search the jobs within an account. By default, only the last 50 jobs are returned. Use the <code>limit</code> and <code>offset</code> parameters to return more than 50 jobs. <a href="https://help.smartling.com/hc/en-us/articles/1260805176869-Pagination" target="_blank">Learn more.</a>
       tags:
         - Jobs
       operationId: getJobsByAccount
@@ -5723,7 +5723,7 @@ paths:
   '/jobs-api/v3/projects/{projectId}/jobs':
     get:
       summary: List jobs within a project
-      description: List / search the jobs within a project.
+      description: List / search the jobs within a project. By default, only the last 50 jobs are returned. Use the <code>limit</code> and <code>offset</code> parameters to return more than 50 jobs. <a href="https://help.smartling.com/hc/en-us/articles/1260805176869-Pagination" target="_blank">Learn more.</a>
       tags:
       - Jobs
       operationId: getJobsByProject