Add pageStart extension to case management pagination (DataDog#3157)

Author: api-clients-generation-pipeline[bot]

.generator/schemas/v2/openapi.yaml

@@ -75976,6 +75976,7 @@ paths:
       x-pagination:
         limitParam: page[size]
         pageParam: page[number]
+        pageStart: 1
         resultsPath: data
     post:
       description: Create a Case

.generator/src/generator/templates/api.j2

@@ -233,7 +233,7 @@ module {{ module_name }}::{{ version|upper }}
         page_size = @api_client.get_attribute_from_path({{ get_container(operation, pagination.limitParam) }}, {{ get_default(operation, pagination.limitParam) }})
         @api_client.set_attribute_from_path(api_version, {{ get_container(operation, pagination.limitParam, True) }}, page_size)
         {%- if pagination.pageParam %}
-        @api_client.set_attribute_from_path(api_version, {{ get_container(operation, pagination.pageParam, True) }}, 0)
+        @api_client.set_attribute_from_path(api_version, {{ get_container(operation, pagination.pageParam, True) }}, {{ pagination.pageStart | default(0) }})
         {%- endif %}
         while true do
             response = {{ operation.operationId|snake_case }}({% for name, parameter in operation|parameters if parameter.required %}{{ name|attribute_name }}, {% endfor %}opts)
@@ -254,7 +254,7 @@ module {{ module_name }}::{{ version|upper }}
             @api_client.set_attribute_from_path(api_version, {{ get_container(operation, pagination.cursorParam, True) }}, @api_client.get_attribute_from_path(response, "{{ pagination.cursorPath }}"))
             {%- endif %}
             {%- if pagination.pageParam %}
-            @api_client.set_attribute_from_path(api_version, {{ get_container(operation, pagination.pageParam, True) }}, @api_client.get_attribute_from_path({{ get_container(operation, pagination.pageParam) }}, 0) + 1)
+            @api_client.set_attribute_from_path(api_version, {{ get_container(operation, pagination.pageParam, True) }}, @api_client.get_attribute_from_path({{ get_container(operation, pagination.pageParam) }}, {{ pagination.pageStart | default(0) }}) + 1)
             {%- endif %}
         end
     end

cassettes/features/v2/case_management/Search-cases-returns-OK-response-with-pagination.frozen

@@ -0,0 +1 @@
+2026-03-25T10:29:24.893Z

cassettes/features/v2/case_management/Search-cases-returns-OK-response-with-pagination.yml

@@ -2,4 +2,8 @@
 
 require "datadog_api_client"
 api_instance = DatadogAPIClient::V2::CaseManagementAPI.new
-api_instance.search_cases_with_pagination() { |item| puts item }
+opts = {
+  page_size: 2,
+  filter: "status:closed",
+}
+api_instance.search_cases_with_pagination(opts) { |item| puts item }

examples/v2/case-management/SearchCases_3433960044.rb

@@ -508,11 +508,14 @@ Feature: Case Management
     When the request is sent
     Then the response status is 200 OK
 
-  @generated @skip @team:DataDog/case-management @with-pagination
+  @replay-only @skip-validation @team:DataDog/case-management @with-pagination
   Scenario: Search cases returns "OK" response with pagination
     Given new "SearchCases" request
+    And request contains "page[size]" parameter with value 2
+    And request contains "filter" parameter with value "status:closed"
     When the request with pagination is sent
     Then the response status is 200 OK
+    And the response has 3 items
 
   @team:DataDog/case-management
   Scenario: Unarchive case returns "Bad Request" response

features/v2/case_management.feature

@@ -1528,14 +1528,14 @@ def search_cases_with_pagination(opts = {})
         api_version = "V2"
         page_size = @api_client.get_attribute_from_path(opts, "page_size", 10)
         @api_client.set_attribute_from_path(api_version, opts, "page_size", Integer, page_size)
-        @api_client.set_attribute_from_path(api_version, opts, "page_number", Integer, 0)
+        @api_client.set_attribute_from_path(api_version, opts, "page_number", Integer, 1)
         while true do
             response = search_cases(opts)
             @api_client.get_attribute_from_path(response, "data").each { |item| yield(item) }
             if @api_client.get_attribute_from_path(response, "data").length < page_size
               break
             end
-            @api_client.set_attribute_from_path(api_version, opts, "page_number", Integer, @api_client.get_attribute_from_path(opts, "page_number", 0) + 1)
+            @api_client.set_attribute_from_path(api_version, opts, "page_number", Integer, @api_client.get_attribute_from_path(opts, "page_number", 1) + 1)
         end
     end