Add DELETE user-binding endpoint to Microsoft Teams Integration spec (#1743)

Co-authored-by: ci.datadog-api-spec <packages@datadoghq.com>

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

.generator/schemas/v2/openapi.yaml

@@ -1012,6 +1012,13 @@ components:
       required: true
       schema:
         type: string
+    MicrosoftTeamsTenantIDPathParameter:
+      description: Your tenant id.
+      in: path
+      name: tenant_id
+      required: true
+      schema:
+        type: string
     MicrosoftTeamsTenantIDQueryParameter:
       description: Your tenant id.
       in: query
@@ -134956,6 +134963,26 @@ paths:
       tags:
         - Microsoft Teams Integration
       x-codegen-request-body-name: body
+  /api/v2/integration/ms-teams/configuration/user-binding/{tenant_id}:
+    delete:
+      description: Delete the user binding for a given tenant from the Datadog Microsoft Teams integration.
+      operationId: DeleteMSTeamsUserBinding
+      parameters:
+        - $ref: "#/components/parameters/MicrosoftTeamsTenantIDPathParameter"
+      responses:
+        "204":
+          description: No Content
+        "400":
+          $ref: "#/components/responses/BadRequestResponse"
+        "403":
+          $ref: "#/components/responses/ForbiddenResponse"
+        "412":
+          $ref: "#/components/responses/PreconditionFailedResponse"
+        "429":
+          $ref: "#/components/responses/TooManyRequestsResponse"
+      summary: Delete user binding
+      tags:
+        - Microsoft Teams Integration
   /api/v2/integration/ms-teams/configuration/workflows-webhook-handles:
     get:
       description: Get a list of all Workflows webhook handles from the Datadog Microsoft Teams integration.

examples/v2_microsoft-teams-integration_DeleteMSTeamsUserBinding.rs

@@ -0,0 +1,17 @@
+// Delete user binding returns "No Content" response
+use datadog_api_client::datadog;
+use datadog_api_client::datadogV2::api_microsoft_teams_integration::MicrosoftTeamsIntegrationAPI;
+
+#[tokio::main]
+async fn main() {
+    let configuration = datadog::Configuration::new();
+    let api = MicrosoftTeamsIntegrationAPI::with_config(configuration);
+    let resp = api
+        .delete_ms_teams_user_binding("tenant_id".to_string())
+        .await;
+    if let Ok(value) = resp {
+        println!("{:#?}", value);
+    } else {
+        println!("{:#?}", resp.unwrap_err());
+    }
+}

src/datadogV2/api/api_microsoft_teams_integration.rs

@@ -65,6 +65,14 @@ pub enum CreateWorkflowsWebhookHandleError {
     UnknownValue(serde_json::Value),
 }
 
+/// DeleteMSTeamsUserBindingError is a struct for typed errors of method [`MicrosoftTeamsIntegrationAPI::delete_ms_teams_user_binding`]
+#[derive(Debug, Clone, Serialize, Deserialize)]
+#[serde(untagged)]
+pub enum DeleteMSTeamsUserBindingError {
+    APIErrorResponse(crate::datadogV2::model::APIErrorResponse),
+    UnknownValue(serde_json::Value),
+}
+
 /// DeleteTenantBasedHandleError is a struct for typed errors of method [`MicrosoftTeamsIntegrationAPI::delete_tenant_based_handle`]
 #[derive(Debug, Clone, Serialize, Deserialize)]
 #[serde(untagged)]
@@ -529,6 +537,97 @@ impl MicrosoftTeamsIntegrationAPI {
         }
     }
 
+    /// Delete the user binding for a given tenant from the Datadog Microsoft Teams integration.
+    pub async fn delete_ms_teams_user_binding(
+        &self,
+        tenant_id: String,
+    ) -> Result<(), datadog::Error<DeleteMSTeamsUserBindingError>> {
+        match self
+            .delete_ms_teams_user_binding_with_http_info(tenant_id)
+            .await
+        {
+            Ok(_) => Ok(()),
+            Err(err) => Err(err),
+        }
+    }
+
+    /// Delete the user binding for a given tenant from the Datadog Microsoft Teams integration.
+    pub async fn delete_ms_teams_user_binding_with_http_info(
+        &self,
+        tenant_id: String,
+    ) -> Result<datadog::ResponseContent<()>, datadog::Error<DeleteMSTeamsUserBindingError>> {
+        let local_configuration = &self.config;
+        let operation_id = "v2.delete_ms_teams_user_binding";
+
+        let local_client = &self.client;
+
+        let local_uri_str = format!(
+            "{}/api/v2/integration/ms-teams/configuration/user-binding/{tenant_id}",
+            local_configuration.get_operation_host(operation_id),
+            tenant_id = datadog::urlencode(tenant_id)
+        );
+        let mut local_req_builder =
+            local_client.request(reqwest::Method::DELETE, local_uri_str.as_str());
+
+        // build headers
+        let mut headers = HeaderMap::new();
+        headers.insert("Accept", HeaderValue::from_static("*/*"));
+
+        // build user agent
+        match HeaderValue::from_str(local_configuration.user_agent.as_str()) {
+            Ok(user_agent) => headers.insert(reqwest::header::USER_AGENT, user_agent),
+            Err(e) => {
+                log::warn!("Failed to parse user agent header: {e}, falling back to default");
+                headers.insert(
+                    reqwest::header::USER_AGENT,
+                    HeaderValue::from_static(datadog::DEFAULT_USER_AGENT.as_str()),
+                )
+            }
+        };
+
+        // build auth
+        if let Some(local_key) = local_configuration.auth_keys.get("apiKeyAuth") {
+            headers.insert(
+                "DD-API-KEY",
+                HeaderValue::from_str(local_key.key.as_str())
+                    .expect("failed to parse DD-API-KEY header"),
+            );
+        };
+        if let Some(local_key) = local_configuration.auth_keys.get("appKeyAuth") {
+            headers.insert(
+                "DD-APPLICATION-KEY",
+                HeaderValue::from_str(local_key.key.as_str())
+                    .expect("failed to parse DD-APPLICATION-KEY header"),
+            );
+        };
+
+        local_req_builder = local_req_builder.headers(headers);
+        let local_req = local_req_builder.build()?;
+        log::debug!("request content: {:?}", local_req.body());
+        let local_resp = local_client.execute(local_req).await?;
+
+        let local_status = local_resp.status();
+        let local_content = local_resp.text().await?;
+        log::debug!("response content: {}", local_content);
+
+        if !local_status.is_client_error() && !local_status.is_server_error() {
+            Ok(datadog::ResponseContent {
+                status: local_status,
+                content: local_content,
+                entity: None,
+            })
+        } else {
+            let local_entity: Option<DeleteMSTeamsUserBindingError> =
+                serde_json::from_str(&local_content).ok();
+            let local_error = datadog::ResponseContent {
+                status: local_status,
+                content: local_content,
+                entity: local_entity,
+            };
+            Err(datadog::Error::ResponseError(local_error))
+        }
+    }
+
     /// Delete a tenant-based handle from the Datadog Microsoft Teams integration.
     pub async fn delete_tenant_based_handle(
         &self,

tests/scenarios/features/v2/microsoft_teams_integration.feature

@@ -146,6 +146,27 @@ Feature: Microsoft Teams Integration
     When the request is sent
     Then the response status is 204 OK
 
+  @generated @skip @team:DataDog/chat-integrations
+  Scenario: Delete user binding returns "Bad Request" response
+    Given new "DeleteMSTeamsUserBinding" request
+    And request contains "tenant_id" parameter from "REPLACE.ME"
+    When the request is sent
+    Then the response status is 400 Bad Request
+
+  @generated @skip @team:DataDog/chat-integrations
+  Scenario: Delete user binding returns "Failed Precondition" response
+    Given new "DeleteMSTeamsUserBinding" request
+    And request contains "tenant_id" parameter from "REPLACE.ME"
+    When the request is sent
+    Then the response status is 412 Failed Precondition
+
+  @generated @skip @team:DataDog/chat-integrations
+  Scenario: Delete user binding returns "No Content" response
+    Given new "DeleteMSTeamsUserBinding" request
+    And request contains "tenant_id" parameter from "REPLACE.ME"
+    When the request is sent
+    Then the response status is 204 No Content
+
   @team:DataDog/chat-integrations
   Scenario: Delete workflow webhook handle returns "OK" response
     Given there is a valid "workflows_webhook_handle" in the system

tests/scenarios/features/v2/undo.json

@@ -3529,6 +3529,12 @@
       "type": "idempotent"
     }
   },
+  "DeleteMSTeamsUserBinding": {
+    "tag": "Microsoft Teams Integration",
+    "undo": {
+      "type": "idempotent"
+    }
+  },
   "ListWorkflowsWebhookHandles": {
     "tag": "Microsoft Teams Integration",
     "undo": {

tests/scenarios/function_mappings.rs

@@ -5017,6 +5017,10 @@ pub fn collect_function_calls(world: &mut DatadogWorld) {
         "v2.UpdateTenantBasedHandle".into(),
         test_v2_update_tenant_based_handle,
     );
+    world.function_mappings.insert(
+        "v2.DeleteMSTeamsUserBinding".into(),
+        test_v2_delete_ms_teams_user_binding,
+    );
     world.function_mappings.insert(
         "v2.ListWorkflowsWebhookHandles".into(),
         test_v2_list_workflows_webhook_handles,
@@ -38549,6 +38553,34 @@ fn test_v2_update_tenant_based_handle(
     world.response.code = response.status.as_u16();
 }
 
+fn test_v2_delete_ms_teams_user_binding(
+    world: &mut DatadogWorld,
+    _parameters: &HashMap<String, Value>,
+) {
+    let api = world
+        .api_instances
+        .v2_api_microsoft_teams_integration
+        .as_ref()
+        .expect("api instance not found");
+    let tenant_id = serde_json::from_value(_parameters.get("tenant_id").unwrap().clone()).unwrap();
+    let response = match block_on(api.delete_ms_teams_user_binding_with_http_info(tenant_id)) {
+        Ok(response) => response,
+        Err(error) => {
+            return match error {
+                Error::ResponseError(e) => {
+                    world.response.code = e.status.as_u16();
+                    if let Some(entity) = e.entity {
+                        world.response.object = serde_json::to_value(entity).unwrap();
+                    }
+                }
+                _ => panic!("error parsing response: {error}"),
+            };
+        }
+    };
+    world.response.object = serde_json::to_value(response.entity).unwrap();
+    world.response.code = response.status.as_u16();
+}
+
 fn test_v2_list_workflows_webhook_handles(
     world: &mut DatadogWorld,
     _parameters: &HashMap<String, Value>,