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

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

@@ -370,7 +370,7 @@ func (a *{{ classname }}) {{ operation.operationId }}WithPagination(ctx _context
 	{{ get_container(operation, pagination.limitParam) }} = &pageSize_
 	{%- if pagination.pageParam %}
 	{%- set pageType = get_container_type(operation, pagination.pageParam) %}
-        page_ := {{ pageType }}(0)
+        page_ := {{ pageType }}({{ pagination.pageStart | default(0) }})
 	{{ get_container(operation, pagination.pageParam) }} = &page_
 	{%- endif %}
 	{%- endif %}

api/datadogV2/api_case_management.go

@@ -1807,7 +1807,7 @@ func (a *CaseManagementApi) SearchCasesWithPagination(ctx _context.Context, o ..
 		pageSize_ = *o[0].PageSize
 	}
 	o[0].PageSize = &pageSize_
-	page_ := int64(0)
+	page_ := int64(1)
 	o[0].PageNumber = &page_
 
 	items := make(chan datadog.PaginationResult[Case], pageSize_)

examples/v2/case-management/SearchCases_3433960044.go

@@ -17,7 +17,7 @@ func main() {
 	configuration := datadog.NewConfiguration()
 	apiClient := datadog.NewAPIClient(configuration)
 	api := datadogV2.NewCaseManagementApi(apiClient)
-	resp, _ := api.SearchCasesWithPagination(ctx, *datadogV2.NewSearchCasesOptionalParameters())
+	resp, _ := api.SearchCasesWithPagination(ctx, *datadogV2.NewSearchCasesOptionalParameters().WithPageSize(2).WithFilter("status:closed"))
 
 	for paginationResult := range resp {
 		if paginationResult.Error != nil {

tests/scenarios/cassettes/TestScenarios/v2/Feature_Case_Management/Scenario_Search_cases_returns_OK_response_with_pagination.freeze

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

tests/scenarios/cassettes/TestScenarios/v2/Feature_Case_Management/Scenario_Search_cases_returns_OK_response_with_pagination.yaml

@@ -0,0 +1,42 @@
+interactions:
+- request:
+    body: ''
+    form: {}
+    headers:
+      Accept:
+      - application/json
+    id: 0
+    method: GET
+    url: https://api.datadoghq.com/api/v2/cases?page%5Bsize%5D=2&page%5Bnumber%5D=1&filter=status%3Aclosed
+  response:
+    body: '{"data":[{"id":"cd4abeaa-0a5b-4b83-b99c-5b6d1f912938","type":"case","attributes":{"attributes":{"service":["synthetics-browser"]},"closed_at":"2026-01-24T00:47:45.477244496Z","comment_count":0,"created_at":"2025-11-12T00:42:59.178125Z","created_by_author":{"type":"USER","content":{"ID":"9919ec9b-ebc7-49ee-8dc8-03626e717cca","name":"CI
+      Account","email":"team-intg-tools-libs-spam@datadoghq.com","handle":"9919ec9b-ebc7-49ee-8dc8-03626e717cca","active":true}},"creation_source":"ERROR_TRACKING","custom_attributes":{},"description":"","insights":[{"type":"ERROR_TRACKING","ref":"/error-tracking?issueId=a5bb2896-a4d0-11f0-bd76-da7ad0900002","resource_id":"a5bb2896-a4d0-11f0-bd76-da7ad0900002"}],"internal_id":"cd4abeaa-0a5b-4b83-b99c-5b6d1f912938","key":"ET-3","merge_status":"NOT_MERGED","modified_at":"2026-02-05T03:58:14.876711989Z","priority":"NOT_DEFINED","public_id":"89979","status":"CLOSED","status_group":"SG_CLOSED","status_name":"Closed","title":"require-trusted-types-for:
+      csp_violation: ''trusted-types-sink'' blocked by ''require-trusted-types-for''
+      directive","type":"ERROR_TRACKING_ISSUE","type_id":"00000000-0000-0000-0000-000000000005"},"relationships":{"assignee":{"data":{"id":"87cb11a0-278c-440a-99fe-701223c80296","type":"user"}},"created_by":{"data":{"id":"9919ec9b-ebc7-49ee-8dc8-03626e717cca","type":"user"}},"project":{"data":{"id":"384521ba-dc5f-481f-942d-15bd48428029","type":"project"}}}},{"id":"7afc10c8-4096-4af1-9ccf-ec0df3a2f63b","type":"case","attributes":{"attributes":{"service":["synthetics-browser"]},"comment_count":0,"created_at":"2025-09-02T13:56:48.031226Z","created_by_author":{"type":"USER","content":{"ID":"3ad549bf-eba0-11e9-a77a-0705486660d0","name":"frog","email":"frog@datadoghq.com","handle":"frog@datadoghq.com","active":true}},"creation_source":"ERROR_TRACKING","custom_attributes":{},"description":"","insights":[{"type":"ERROR_TRACKING","ref":"/error-tracking?issueId=d3ab59c6-84ee-11f0-87bb-da7ad0900002","resource_id":"d3ab59c6-84ee-11f0-87bb-da7ad0900002"}],"internal_id":"7afc10c8-4096-4af1-9ccf-ec0df3a2f63b","key":"ET-2","merge_status":"NOT_MERGED","modified_at":"2026-03-25T09:56:47.052997427Z","priority":"NOT_DEFINED","public_id":"79361","status":"CLOSED","status_group":"SG_CLOSED","status_name":"Closed","title":"Error:
+      Expected unhandled error","type":"ERROR_TRACKING_ISSUE","type_id":"00000000-0000-0000-0000-000000000005"},"relationships":{"assignee":{"data":{"id":"87cb11a0-278c-440a-99fe-701223c80296","type":"user"}},"created_by":{"data":{"id":"3ad549bf-eba0-11e9-a77a-0705486660d0","type":"user"}},"project":{"data":{"id":"384521ba-dc5f-481f-942d-15bd48428029","type":"project"}}}}],"meta":{"total_cases":3,"page":{"current":1,"size":2,"total":2}},"included":[{"id":"87cb11a0-278c-440a-99fe-701223c80296","type":"user","attributes":{"active":false,"email":"","handle":"","name":""}},{"id":"9919ec9b-ebc7-49ee-8dc8-03626e717cca","type":"user","attributes":{"active":true,"email":"team-intg-tools-libs-spam@datadoghq.com","handle":"9919ec9b-ebc7-49ee-8dc8-03626e717cca","name":"CI
+      Account"}},{"id":"3ad549bf-eba0-11e9-a77a-0705486660d0","type":"user","attributes":{"active":true,"email":"frog@datadoghq.com","handle":"frog@datadoghq.com","name":"frog"}}]}'
+    code: 200
+    duration: 0ms
+    headers:
+      Content-Type:
+      - application/vnd.api+json
+    status: 200 OK
+- request:
+    body: ''
+    form: {}
+    headers:
+      Accept:
+      - application/json
+    id: 1
+    method: GET
+    url: https://api.datadoghq.com/api/v2/cases?page%5Bsize%5D=2&page%5Bnumber%5D=2&filter=status%3Aclosed
+  response:
+    body: '{"data":[{"id":"f1b32a47-621d-4c57-9642-045aeb83891e","type":"case","attributes":{"attributes":{"service":["synthetics-browser"]},"closed_at":"2025-08-21T17:21:13.882830862Z","comment_count":0,"created_at":"2025-08-21T17:20:22.807979Z","created_by_author":{"type":"USER","content":{"ID":"3ad549bf-eba0-11e9-a77a-0705486660d0","name":"frog","email":"frog@datadoghq.com","handle":"frog@datadoghq.com","active":true}},"creation_source":"ERROR_TRACKING","custom_attributes":{},"description":"","insights":[{"type":"ERROR_TRACKING","ref":"/error-tracking?issueId=5f8ebd5c-6dd9-11f0-8a28-da7ad0900002","resource_id":"5f8ebd5c-6dd9-11f0-8a28-da7ad0900002"}],"internal_id":"f1b32a47-621d-4c57-9642-045aeb83891e","key":"ET-1","merge_status":"NOT_MERGED","modified_at":"2025-08-21T17:21:13.882830862Z","priority":"NOT_DEFINED","public_id":"77795","status":"CLOSED","status_group":"SG_CLOSED","status_name":"Closed","title":"Error:
+      HTTP error","type":"ERROR_TRACKING_ISSUE","type_id":"00000000-0000-0000-0000-000000000005"},"relationships":{"assignee":{"data":{"id":"87cb11a0-278c-440a-99fe-701223c80296","type":"user"}},"created_by":{"data":{"id":"3ad549bf-eba0-11e9-a77a-0705486660d0","type":"user"}},"project":{"data":{"id":"384521ba-dc5f-481f-942d-15bd48428029","type":"project"}}}}],"meta":{"total_cases":3,"page":{"current":2,"size":1,"total":2}},"included":[{"id":"3ad549bf-eba0-11e9-a77a-0705486660d0","type":"user","attributes":{"active":true,"email":"frog@datadoghq.com","handle":"frog@datadoghq.com","name":"frog"}},{"id":"87cb11a0-278c-440a-99fe-701223c80296","type":"user","attributes":{"active":false,"email":"","handle":"","name":""}}]}'
+    code: 200
+    duration: 0ms
+    headers:
+      Content-Type:
+      - application/vnd.api+json
+    status: 200 OK
+version: 2

tests/scenarios/features/v2/case_management.feature

@@ -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