Regenerate client from commit 460691c of spec repo

Author: ci.datadog-api-spec

.generator/schemas/v2/openapi.yaml

@@ -435,6 +435,14 @@ components:
       schema:
         example: "service:myservice"
         type: string
+    EntityIntegrationConfigID:
+      description: The identifier of the integration whose configuration is being managed. Supported values are `github`, `jira`, and `pagerduty`.
+      in: path
+      name: integration_id
+      required: true
+      schema:
+        example: github
+        type: string
     FastlyAccountID:
       description: Fastly Account id.
       in: path
@@ -26856,6 +26864,103 @@ components:
           description: Entity.
           type: string
       type: object
+    EntityIntegrationConfigAttributes:
+      description: Attributes of an entity integration configuration resource.
+      properties:
+        config:
+          $ref: "#/components/schemas/EntityIntegrationConfigPayload"
+        integration_id:
+          description: The identifier of the integration this configuration applies to (for example, `github`, `jira`, or `pagerduty`).
+          example: github
+          type: string
+        org_id:
+          description: The Datadog organization identifier that owns this configuration.
+          example: 1234
+          format: int64
+          type: integer
+      required:
+        - org_id
+        - integration_id
+        - config
+      type: object
+    EntityIntegrationConfigData:
+      description: JSON:API resource object for an entity integration configuration.
+      properties:
+        attributes:
+          $ref: "#/components/schemas/EntityIntegrationConfigAttributes"
+        id:
+          description: Unique identifier of the entity integration configuration.
+          example: 01HJABCD12345678ABCDEFGHIJ
+          type: string
+        type:
+          $ref: "#/components/schemas/EntityIntegrationConfigType"
+      required:
+        - id
+        - type
+        - attributes
+      type: object
+    EntityIntegrationConfigPayload:
+      additionalProperties: {}
+      description: Integration-specific configuration payload. The shape of this object depends on the integration identified by the path parameter. For `github`, the object must contain an `enabled_repos` array. For `jira`, it must contain an `enabled_projects` array. For `pagerduty`, it must contain the PagerDuty-specific configuration.
+      example:
+        enabled_repos:
+          - github_org_name: myorg
+            hostname: github.com
+            repo_name: myrepo
+      type: object
+    EntityIntegrationConfigRequest:
+      description: Request body used to create or replace the configuration for a given integration.
+      properties:
+        data:
+          $ref: "#/components/schemas/EntityIntegrationConfigRequestData"
+      required:
+        - data
+      type: object
+    EntityIntegrationConfigRequestAttributes:
+      description: Attributes used to create or update an entity integration configuration.
+      properties:
+        config:
+          $ref: "#/components/schemas/EntityIntegrationConfigPayload"
+      required:
+        - config
+      type: object
+    EntityIntegrationConfigRequestData:
+      description: JSON:API resource object used in a request to update an entity integration configuration.
+      properties:
+        attributes:
+          $ref: "#/components/schemas/EntityIntegrationConfigRequestAttributes"
+        type:
+          $ref: "#/components/schemas/EntityIntegrationConfigRequestType"
+      required:
+        - type
+        - attributes
+      type: object
+    EntityIntegrationConfigRequestType:
+      default: entity_integration_config_requests
+      description: JSON:API resource type for the entity integration configuration update request. Always `entity_integration_config_requests`.
+      enum:
+        - entity_integration_config_requests
+      example: entity_integration_config_requests
+      type: string
+      x-enum-varnames:
+        - ENTITY_INTEGRATION_CONFIG_REQUESTS
+    EntityIntegrationConfigResponse:
+      description: JSON:API document containing a single entity integration configuration resource.
+      properties:
+        data:
+          $ref: "#/components/schemas/EntityIntegrationConfigData"
+      required:
+        - data
+      type: object
+    EntityIntegrationConfigType:
+      default: entity_integration_configs
+      description: JSON:API resource type for an entity integration configuration. Always `entity_integration_configs`.
+      enum:
+        - entity_integration_configs
+      example: entity_integration_configs
+      type: string
+      x-enum-varnames:
+        - ENTITY_INTEGRATION_CONFIGS
     EntityMeta:
       description: Entity metadata.
       properties:
@@ -113005,6 +113110,170 @@ paths:
       x-unstable: |-
         **Note**: This endpoint is in public beta and is subject to change.
         If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).
+  /api/v2/idp/entity_integrations/{integration_id}:
+    delete:
+      description: Delete the configuration stored for a given integration in the caller's organization. The integration is identified by the `integration_id` path parameter.
+      operationId: DeleteEntityIntegrationConfig
+      parameters:
+        - $ref: "#/components/parameters/EntityIntegrationConfigID"
+      responses:
+        "204":
+          description: No Content
+        "400":
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/JSONAPIErrorResponse"
+          description: Bad Request
+        "403":
+          $ref: "#/components/responses/NotAuthorizedResponse"
+        "404":
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/JSONAPIErrorResponse"
+          description: Not Found
+        "429":
+          $ref: "#/components/responses/TooManyRequestsResponse"
+      summary: Delete an entity integration configuration
+      tags:
+        - Entity Integration Configs
+      x-permission:
+        operator: OR
+        permissions:
+          - manage_integrations
+      x-unstable: |-
+        **Note**: This endpoint is in preview and is subject to change.
+        If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).
+    get:
+      description: Retrieve the configuration currently stored for a given integration in the caller's organization. The integration is identified by the `integration_id` path parameter.
+      operationId: GetEntityIntegrationConfig
+      parameters:
+        - $ref: "#/components/parameters/EntityIntegrationConfigID"
+      responses:
+        "200":
+          content:
+            application/json:
+              example:
+                data:
+                  attributes:
+                    config:
+                      enabled_repos:
+                        - github_org_name: myorg
+                          hostname: github.com
+                          repo_name: myrepo
+                    integration_id: github
+                    org_id: 1234
+                  id: 01HJABCD12345678ABCDEFGHIJ
+                  type: entity_integration_configs
+              schema:
+                $ref: "#/components/schemas/EntityIntegrationConfigResponse"
+          description: OK
+        "400":
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/JSONAPIErrorResponse"
+          description: Bad Request
+        "403":
+          $ref: "#/components/responses/NotAuthorizedResponse"
+        "404":
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/JSONAPIErrorResponse"
+          description: Not Found
+        "429":
+          $ref: "#/components/responses/TooManyRequestsResponse"
+      summary: Get an entity integration configuration
+      tags:
+        - Entity Integration Configs
+      x-permission:
+        operator: OR
+        permissions:
+          - integrations_read
+      x-unstable: |-
+        **Note**: This endpoint is in preview and is subject to change.
+        If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).
+    put:
+      description: |-
+        Create or replace the configuration for a given integration in the caller's organization. The integration is identified by the `integration_id` path parameter. The shape of `data.attributes.config` depends on the integration:
+
+        - For `github`: `config` must contain an `enabled_repos` array of objects with `hostname`, `github_org_name`, and `repo_name`.
+        - For `jira`: `config` must contain an `enabled_projects` array of objects with `hostname`, `account_id`, and `project_key`.
+        - For `pagerduty`: `config` must follow the PagerDuty-specific schema.
+      operationId: UpdateEntityIntegrationConfig
+      parameters:
+        - $ref: "#/components/parameters/EntityIntegrationConfigID"
+      requestBody:
+        content:
+          application/json:
+            examples:
+              default:
+                summary: GitHub integration configuration
+                value:
+                  data:
+                    attributes:
+                      config:
+                        enabled_repos:
+                          - github_org_name: myorg
+                            hostname: github.com
+                            repo_name: myrepo
+                    type: entity_integration_config_requests
+              jira:
+                summary: Jira integration configuration
+                value:
+                  data:
+                    attributes:
+                      config:
+                        enabled_projects:
+                          - account_id: "123456789"
+                            hostname: mycompany.atlassian.net
+                            project_key: AAA
+                    type: entity_integration_config_requests
+            schema:
+              $ref: "#/components/schemas/EntityIntegrationConfigRequest"
+        required: true
+      responses:
+        "200":
+          content:
+            application/json:
+              example:
+                data:
+                  attributes:
+                    config:
+                      enabled_repos:
+                        - github_org_name: myorg
+                          hostname: github.com
+                          repo_name: myrepo
+                    integration_id: github
+                    org_id: 1234
+                  id: 01HJABCD12345678ABCDEFGHIJ
+                  type: entity_integration_configs
+              schema:
+                $ref: "#/components/schemas/EntityIntegrationConfigResponse"
+          description: OK
+        "400":
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/JSONAPIErrorResponse"
+          description: Bad Request
+        "403":
+          $ref: "#/components/responses/NotAuthorizedResponse"
+        "429":
+          $ref: "#/components/responses/TooManyRequestsResponse"
+      summary: Update an entity integration configuration
+      tags:
+        - Entity Integration Configs
+      x-codegen-request-body-name: body
+      x-permission:
+        operator: OR
+        permissions:
+          - integrations_read
+      x-unstable: |-
+        **Note**: This endpoint is in preview and is subject to change.
+        If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).
   /api/v2/incidents:
     get:
       description: >-
@@ -159452,6 +159721,8 @@ tags:
       scopes from alerting. Downtime settings, which can be scheduled with start and
       end times, prevent all alerting related to specified Datadog tags.
     name: Downtimes
+  - description: Manage per-integration configurations for the Internal Developer Portal (IDP). These configurations control which external resources (for example, GitHub repositories, Jira projects, or PagerDuty services) are synced as entities into the Software Catalog.
+    name: Entity Integration Configs
   - description: Retrieves security risk scores for entities in your organization.
     name: Entity Risk Scores
   - description: View and manage issues within Error Tracking. See the [Error Tracking page](https://docs.datadoghq.com/error_tracking/) for more information.

docs/datadog_api_client.v2.api.rst

@@ -284,6 +284,13 @@ datadog\_api\_client.v2.api.downtimes\_api module
    :members:
    :show-inheritance:
 
+datadog\_api\_client.v2.api.entity\_integration\_configs\_api module
+--------------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.api.entity_integration_configs_api
+   :members:
+   :show-inheritance:
+
 datadog\_api\_client.v2.api.entity\_risk\_scores\_api module
 ------------------------------------------------------------
 

docs/datadog_api_client.v2.model.rst

@@ -11015,6 +11015,69 @@ datadog\_api\_client.v2.model.entity\_data module
    :members:
    :show-inheritance:
 
+datadog\_api\_client.v2.model.entity\_integration\_config\_attributes module
+----------------------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.entity_integration_config_attributes
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.entity\_integration\_config\_data module
+----------------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.entity_integration_config_data
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.entity\_integration\_config\_payload module
+-------------------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.entity_integration_config_payload
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.entity\_integration\_config\_request module
+-------------------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.entity_integration_config_request
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.entity\_integration\_config\_request\_attributes module
+-------------------------------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.entity_integration_config_request_attributes
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.entity\_integration\_config\_request\_data module
+-------------------------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.entity_integration_config_request_data
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.entity\_integration\_config\_request\_type module
+-------------------------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.entity_integration_config_request_type
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.entity\_integration\_config\_response module
+--------------------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.entity_integration_config_response
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.entity\_integration\_config\_type module
+----------------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.entity_integration_config_type
+   :members:
+   :show-inheritance:
+
 datadog\_api\_client.v2.model.entity\_meta module
 -------------------------------------------------
 

examples/v2/entity-integration-configs/DeleteEntityIntegrationConfig.py

@@ -0,0 +1,14 @@
+"""
+Delete an entity integration configuration returns "No Content" response
+"""
+
+from datadog_api_client import ApiClient, Configuration
+from datadog_api_client.v2.api.entity_integration_configs_api import EntityIntegrationConfigsApi
+
+configuration = Configuration()
+configuration.unstable_operations["delete_entity_integration_config"] = True
+with ApiClient(configuration) as api_client:
+    api_instance = EntityIntegrationConfigsApi(api_client)
+    api_instance.delete_entity_integration_config(
+        integration_id="github",
+    )