[PAPI-1336] Adjust documentation of the updated_since filter for the Employees endpoint

personio-personnel-data-api-oa3.yaml

@@ -49,7 +49,13 @@ paths:
         - name: updated_since
           in: query
           required: false
-          description: "Find all employees that have been updated since the provided date. The format is `ISO 8601` (2022-12-24T08:15:30). NOTE: when using the updated_since filter, the email, limit, and offset parameters are ignored."
+          description: >
+            Find all employees that have been updated since the provided date. 
+            The format is `ISO 8601` (2022-12-24T08:15:30).
+            This filter is returning a paginated response. Therefore, it is necessary to provide the limit and offset
+            parameters when using this filter. In case a request is send without the limit and offset parameters, a
+            default limit of 200 is used and the offset is set to 0.
+            NOTE: when using the updated_since filter, the email parameters is ignored.
           schema:
             type: string
             example: 2022-12-24T08:15:30