Add delete log index to public API (#2441)

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.6",
-            "regenerated": "2025-03-06 18:30:09.334459",
-            "spec_repo_commit": "fb234cde"
+            "regenerated": "2025-03-06 19:05:51.416503",
+            "spec_repo_commit": "b892dbfc"
         },
         "v2": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2025-03-06 18:30:09.350543",
-            "spec_repo_commit": "fb234cde"
+            "regenerated": "2025-03-06 19:05:51.625848",
+            "spec_repo_commit": "b892dbfc"
         }
     }
 }

.generator/schemas/v1/openapi.yaml

@@ -28758,6 +28758,47 @@ paths:
         permissions:
         - logs_modify_indexes
   /api/v1/logs/config/indexes/{name}:
+    delete:
+      description: 'Delete an existing index from your organization. Index deletions
+        are permanent and cannot be reverted.
+
+        You cannot recreate an index with the same name as deleted ones.'
+      operationId: DeleteLogsIndex
+      parameters:
+      - description: Name of the log index.
+        in: path
+        name: name
+        required: true
+        schema:
+          type: string
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/LogsIndex'
+          description: OK
+        '403':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Forbidden
+        '404':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/LogsAPIErrorResponse'
+          description: Not Found
+        '429':
+          $ref: '#/components/responses/TooManyRequestsResponse'
+      summary: Delete an index
+      tags:
+      - Logs Indexes
+      x-permission:
+        operator: OR
+        permissions:
+        - logs_modify_indexes
     get:
       description: Get one log index from your organization. This endpoint takes no
         JSON arguments.

examples/v1/logs-indexes/DeleteLogsIndex.py

@@ -0,0 +1,15 @@
+"""
+Delete an index returns "OK" response
+"""
+
+from datadog_api_client import ApiClient, Configuration
+from datadog_api_client.v1.api.logs_indexes_api import LogsIndexesApi
+
+configuration = Configuration()
+with ApiClient(configuration) as api_client:
+    api_instance = LogsIndexesApi(api_client)
+    response = api_instance.delete_logs_index(
+        name="name",
+    )
+
+    print(response)

src/datadog_api_client/v1/api/logs_indexes_api.py

@@ -43,6 +43,29 @@ def __init__(self, api_client=None):
             api_client=api_client,
         )
 
+        self._delete_logs_index_endpoint = _Endpoint(
+            settings={
+                "response_type": (LogsIndex,),
+                "auth": ["apiKeyAuth", "appKeyAuth"],
+                "endpoint_path": "/api/v1/logs/config/indexes/{name}",
+                "operation_id": "delete_logs_index",
+                "http_method": "DELETE",
+                "version": "v1",
+            },
+            params_map={
+                "name": {
+                    "required": True,
+                    "openapi_types": (str,),
+                    "attribute": "name",
+                    "location": "path",
+                },
+            },
+            headers_map={
+                "accept": ["application/json"],
+            },
+            api_client=api_client,
+        )
+
         self._get_logs_index_endpoint = _Endpoint(
             settings={
                 "response_type": (LogsIndex,),
@@ -161,6 +184,24 @@ def create_logs_index(
 
         return self._create_logs_index_endpoint.call_with_http_info(**kwargs)
 
+    def delete_logs_index(
+        self,
+        name: str,
+    ) -> LogsIndex:
+        """Delete an index.
+
+        Delete an existing index from your organization. Index deletions are permanent and cannot be reverted.
+        You cannot recreate an index with the same name as deleted ones.
+
+        :param name: Name of the log index.
+        :type name: str
+        :rtype: LogsIndex
+        """
+        kwargs: Dict[str, Any] = {}
+        kwargs["name"] = name
+
+        return self._delete_logs_index_endpoint.call_with_http_info(**kwargs)
+
     def get_logs_index(
         self,
         name: str,

tests/v1/features/logs_indexes.feature

@@ -22,6 +22,20 @@ Feature: Logs Indexes
     When the request is sent
     Then the response status is 200 OK
 
+  @generated @skip @team:DataDog/logs-backend @team:DataDog/logs-core
+  Scenario: Delete an index returns "Not Found" response
+    Given new "DeleteLogsIndex" request
+    And request contains "name" parameter from "REPLACE.ME"
+    When the request is sent
+    Then the response status is 404 Not Found
+
+  @generated @skip @team:DataDog/logs-backend @team:DataDog/logs-core
+  Scenario: Delete an index returns "OK" response
+    Given new "DeleteLogsIndex" request
+    And request contains "name" parameter from "REPLACE.ME"
+    When the request is sent
+    Then the response status is 200 OK
+
   @generated @skip @team:DataDog/logs-backend @team:DataDog/logs-core
   Scenario: Get all indexes returns "OK" response
     Given new "ListLogIndexes" request

tests/v1/features/undo.json

@@ -694,6 +694,12 @@
       "type": "unsafe"
     }
   },
+  "DeleteLogsIndex": {
+    "tag": "Logs Indexes",
+    "undo": {
+      "type": "idempotent"
+    }
+  },
   "GetLogsIndex": {
     "tag": "Logs Indexes",
     "undo": {