Deprecate Incident Services endpoints (#1904)

Co-authored-by: ci.datadog-api-spec <packages@datadoghq.com>
Co-authored-by: api-clients-generation-pipeline[bot] <54105614+api-clients-generation-pipeline[bot]@users.noreply.github.com>

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

.apigentools-info

@@ -4,13 +4,13 @@
     "spec_versions": {
         "v1": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2024-03-11 18:06:45.607287",
-            "spec_repo_commit": "ac12ffe4"
+            "regenerated": "2024-03-12 14:55:32.911544",
+            "spec_repo_commit": "e9113926"
         },
         "v2": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2024-03-11 18:06:45.623937",
-            "spec_repo_commit": "ac12ffe4"
+            "regenerated": "2024-03-12 14:55:32.926760",
+            "spec_repo_commit": "e9113926"
         }
     }
 }

.generator/schemas/v2/openapi.yaml

@@ -32528,6 +32528,7 @@ paths:
       x-codegen-request-body-name: body
   /api/v2/services:
     get:
+      deprecated: true
       description: Get all incident services uploaded for the requesting user's organization.
         If the `include[users]` query parameter is provided, the included attribute
         will contain the users related to these incident services.
@@ -32562,10 +32563,9 @@ paths:
       summary: Get a list of all incident services
       tags:
       - Incident Services
-      x-unstable: '**Note**: This endpoint is in public beta.
-
-        If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).'
+      x-unstable: '**Note**: This endpoint is deprecated.'
     post:
+      deprecated: true
       description: Creates a new incident service.
       operationId: CreateIncidentService
       requestBody:
@@ -32601,9 +32601,7 @@ paths:
       tags:
       - Incident Services
       x-codegen-request-body-name: body
-      x-unstable: '**Note**: This endpoint is in public beta.
-
-        If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).'
+      x-unstable: '**Note**: This endpoint is deprecated.'
   /api/v2/services/definitions:
     get:
       description: Get a list of all service definitions from the Datadog Service
@@ -32728,6 +32726,7 @@ paths:
       - Service Definition
   /api/v2/services/{service_id}:
     delete:
+      deprecated: true
       description: Deletes an existing incident service.
       operationId: DeleteIncidentService
       parameters:
@@ -32753,10 +32752,9 @@ paths:
       summary: Delete an existing incident service
       tags:
       - Incident Services
-      x-unstable: '**Note**: This endpoint is in public beta.
-
-        If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).'
+      x-unstable: '**Note**: This endpoint is deprecated.'
     get:
+      deprecated: true
       description: 'Get details of an incident service. If the `include[users]` query
         parameter is provided,
 
@@ -32790,10 +32788,9 @@ paths:
       summary: Get details of an incident service
       tags:
       - Incident Services
-      x-unstable: '**Note**: This endpoint is in public beta.
-
-        If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).'
+      x-unstable: '**Note**: This endpoint is deprecated.'
     patch:
+      deprecated: true
       description: Updates an existing incident service. Only provide the attributes
         which should be updated as this request is a partial update.
       operationId: UpdateIncidentService
@@ -32832,9 +32829,7 @@ paths:
       tags:
       - Incident Services
       x-codegen-request-body-name: body
-      x-unstable: '**Note**: This endpoint is in public beta.
-
-        If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).'
+      x-unstable: '**Note**: This endpoint is deprecated.'
   /api/v2/spans/analytics/aggregate:
     post:
       description: 'The API endpoint to aggregate spans into buckets and compute metrics

src/datadog_api_client/v2/api/incident_services_api.py

@@ -4,6 +4,7 @@
 from __future__ import annotations
 
 from typing import Any, Dict, Union
+import warnings
 
 from datadog_api_client.api_client import ApiClient, Endpoint as _Endpoint
 from datadog_api_client.configuration import Configuration
@@ -166,7 +167,7 @@ def create_incident_service(
         self,
         body: IncidentServiceCreateRequest,
     ) -> IncidentServiceResponse:
-        """Create a new incident service.
+        """Create a new incident service. **Deprecated**.
 
         Creates a new incident service.
 
@@ -177,13 +178,14 @@ def create_incident_service(
         kwargs: Dict[str, Any] = {}
         kwargs["body"] = body
 
+        warnings.warn("create_incident_service is deprecated", DeprecationWarning, stacklevel=2)
         return self._create_incident_service_endpoint.call_with_http_info(**kwargs)
 
     def delete_incident_service(
         self,
         service_id: str,
     ) -> None:
-        """Delete an existing incident service.
+        """Delete an existing incident service. **Deprecated**.
 
         Deletes an existing incident service.
 
@@ -194,6 +196,7 @@ def delete_incident_service(
         kwargs: Dict[str, Any] = {}
         kwargs["service_id"] = service_id
 
+        warnings.warn("delete_incident_service is deprecated", DeprecationWarning, stacklevel=2)
         return self._delete_incident_service_endpoint.call_with_http_info(**kwargs)
 
     def get_incident_service(
@@ -202,7 +205,7 @@ def get_incident_service(
         *,
         include: Union[IncidentRelatedObject, UnsetType] = unset,
     ) -> IncidentServiceResponse:
-        """Get details of an incident service.
+        """Get details of an incident service. **Deprecated**.
 
         Get details of an incident service. If the ``include[users]`` query parameter is provided,
         the included attribute will contain the users related to these incident services.
@@ -219,6 +222,7 @@ def get_incident_service(
         if include is not unset:
             kwargs["include"] = include
 
+        warnings.warn("get_incident_service is deprecated", DeprecationWarning, stacklevel=2)
         return self._get_incident_service_endpoint.call_with_http_info(**kwargs)
 
     def list_incident_services(
@@ -229,7 +233,7 @@ def list_incident_services(
         page_offset: Union[int, UnsetType] = unset,
         filter: Union[str, UnsetType] = unset,
     ) -> IncidentServicesResponse:
-        """Get a list of all incident services.
+        """Get a list of all incident services. **Deprecated**.
 
         Get all incident services uploaded for the requesting user's organization. If the ``include[users]`` query parameter is provided, the included attribute will contain the users related to these incident services.
 
@@ -256,14 +260,15 @@ def list_incident_services(
         if filter is not unset:
             kwargs["filter"] = filter
 
+        warnings.warn("list_incident_services is deprecated", DeprecationWarning, stacklevel=2)
         return self._list_incident_services_endpoint.call_with_http_info(**kwargs)
 
     def update_incident_service(
         self,
         service_id: str,
         body: IncidentServiceUpdateRequest,
     ) -> IncidentServiceResponse:
-        """Update an existing incident service.
+        """Update an existing incident service. **Deprecated**.
 
         Updates an existing incident service. Only provide the attributes which should be updated as this request is a partial update.
 
@@ -278,4 +283,5 @@ def update_incident_service(
 
         kwargs["body"] = body
 
+        warnings.warn("update_incident_service is deprecated", DeprecationWarning, stacklevel=2)
         return self._update_incident_service_endpoint.call_with_http_info(**kwargs)