Deprecate note for Incident Teams endpoints (#1450)

Co-authored-by: ci.datadog-api-spec <[email protected]>

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

.apigentools-info

@@ -4,13 +4,13 @@
     "spec_versions": {
         "v1": {
             "apigentools_version": "1.6.4",
-            "regenerated": "2023-05-04 18:36:58.546008",
-            "spec_repo_commit": "05a49f9c"
+            "regenerated": "2023-05-04 18:52:22.109705",
+            "spec_repo_commit": "4706b973"
         },
         "v2": {
             "apigentools_version": "1.6.4",
-            "regenerated": "2023-05-04 18:36:58.558261",
-            "spec_repo_commit": "05a49f9c"
+            "regenerated": "2023-05-04 18:52:22.122098",
+            "spec_repo_commit": "4706b973"
         }
     }
 }

.generator/schemas/v2/openapi.yaml

@@ -23142,6 +23142,7 @@ paths:
       x-codegen-request-body-name: body
   /api/v2/teams:
     get:
+      deprecated: true
       description: Get all incident teams 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 teams.
@@ -23176,10 +23177,9 @@ paths:
       summary: Get a list of all incident teams
       tags:
       - Incident Teams
-      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. See the [Teams API endpoints](https://docs.datadoghq.com/api/latest/teams/).'
     post:
+      deprecated: true
       description: Creates a new incident team.
       operationId: CreateIncidentTeam
       requestBody:
@@ -23215,11 +23215,10 @@ paths:
       tags:
       - Incident Teams
       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. See the [Teams API endpoints](https://docs.datadoghq.com/api/latest/teams/).'
   /api/v2/teams/{team_id}:
     delete:
+      deprecated: true
       description: Deletes an existing incident team.
       operationId: DeleteIncidentTeam
       parameters:
@@ -23245,10 +23244,9 @@ paths:
       summary: Delete an existing incident team
       tags:
       - Incident Teams
-      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. See the [Teams API endpoints](https://docs.datadoghq.com/api/latest/teams/).'
     get:
+      deprecated: true
       description: 'Get details of an incident team. If the `include[users]` query
         parameter is provided,
 
@@ -23282,10 +23280,9 @@ paths:
       summary: Get details of an incident team
       tags:
       - Incident Teams
-      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. See the [Teams API endpoints](https://docs.datadoghq.com/api/latest/teams/).'
     patch:
+      deprecated: true
       description: Updates an existing incident team. Only provide the attributes
         which should be updated as this request is a partial update.
       operationId: UpdateIncidentTeam
@@ -23324,9 +23321,7 @@ paths:
       tags:
       - Incident Teams
       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. See the [Teams API endpoints](https://docs.datadoghq.com/api/latest/teams/).'
   /api/v2/usage/application_security:
     get:
       description: 'Get hourly usage for application security .
@@ -24331,8 +24326,8 @@ tags:
 - description: Create, update, delete, and retrieve services which can be associated
     with incidents.
   name: Incident Services
-- description: Create, update, delete and retrieve teams which can be associated with
-    incidents.
+- description: The Incident Teams endpoints are deprecated. See the [Teams API endpoints](https://docs.datadoghq.com/api/latest/teams/)
+    to create, update, delete, and retrieve teams which can be associated with incidents.
   name: Incident Teams
 - description: Manage incident response.
   name: Incidents

src/datadog_api_client/v2/api/incident_teams_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
@@ -20,7 +21,7 @@
 
 class IncidentTeamsApi:
     """
-    Create, update, delete and retrieve teams which can be associated with incidents.
+    The Incident Teams endpoints are deprecated. See the `Teams API endpoints <https://docs.datadoghq.com/api/latest/teams/>`_ to create, update, delete, and retrieve teams which can be associated with incidents.
     """
 
     def __init__(self, api_client=None):
@@ -174,7 +175,7 @@ def create_incident_team(
         self,
         body: IncidentTeamCreateRequest,
     ) -> IncidentTeamResponse:
-        """Create a new incident team.
+        """Create a new incident team. **Deprecated**.
 
         Creates a new incident team.
 
@@ -185,13 +186,14 @@ def create_incident_team(
         kwargs: Dict[str, Any] = {}
         kwargs["body"] = body
 
+        warnings.warn("create_incident_team is deprecated", DeprecationWarning, stacklevel=2)
         return self._create_incident_team_endpoint.call_with_http_info(**kwargs)
 
     def delete_incident_team(
         self,
         team_id: str,
     ) -> None:
-        """Delete an existing incident team.
+        """Delete an existing incident team. **Deprecated**.
 
         Deletes an existing incident team.
 
@@ -202,6 +204,7 @@ def delete_incident_team(
         kwargs: Dict[str, Any] = {}
         kwargs["team_id"] = team_id
 
+        warnings.warn("delete_incident_team is deprecated", DeprecationWarning, stacklevel=2)
         return self._delete_incident_team_endpoint.call_with_http_info(**kwargs)
 
     def get_incident_team(
@@ -210,7 +213,7 @@ def get_incident_team(
         *,
         include: Union[IncidentRelatedObject, UnsetType] = unset,
     ) -> IncidentTeamResponse:
-        """Get details of an incident team.
+        """Get details of an incident team. **Deprecated**.
 
         Get details of an incident team. If the ``include[users]`` query parameter is provided,
         the included attribute will contain the users related to these incident teams.
@@ -227,6 +230,7 @@ def get_incident_team(
         if include is not unset:
             kwargs["include"] = include
 
+        warnings.warn("get_incident_team is deprecated", DeprecationWarning, stacklevel=2)
         return self._get_incident_team_endpoint.call_with_http_info(**kwargs)
 
     def list_incident_teams(
@@ -237,7 +241,7 @@ def list_incident_teams(
         page_offset: Union[int, UnsetType] = unset,
         filter: Union[str, UnsetType] = unset,
     ) -> IncidentTeamsResponse:
-        """Get a list of all incident teams.
+        """Get a list of all incident teams. **Deprecated**.
 
         Get all incident teams 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 teams.
 
@@ -264,14 +268,15 @@ def list_incident_teams(
         if filter is not unset:
             kwargs["filter"] = filter
 
+        warnings.warn("list_incident_teams is deprecated", DeprecationWarning, stacklevel=2)
         return self._list_incident_teams_endpoint.call_with_http_info(**kwargs)
 
     def update_incident_team(
         self,
         team_id: str,
         body: IncidentTeamUpdateRequest,
     ) -> IncidentTeamResponse:
-        """Update an existing incident team.
+        """Update an existing incident team. **Deprecated**.
 
         Updates an existing incident team. Only provide the attributes which should be updated as this request is a partial update.
 
@@ -286,4 +291,5 @@ def update_incident_team(
 
         kwargs["body"] = body
 
+        warnings.warn("update_incident_team is deprecated", DeprecationWarning, stacklevel=2)
         return self._update_incident_team_endpoint.call_with_http_info(**kwargs)

tests/v2/features/incident_teams.feature

@@ -1,7 +1,8 @@
 @endpoint(incident-teams) @endpoint(incident-teams-v2)
 Feature: Incident Teams
-  Create, update, delete and retrieve teams which can be associated with
-  incidents.
+  The Incident Teams endpoints are deprecated. See the [Teams API
+  endpoints](https://docs.datadoghq.com/api/latest/teams/) to create,
+  update, delete, and retrieve teams which can be associated with incidents.
 
   Background:
     Given a valid "apiKeyAuth" key in the system