Add OpenAPI spec for OAuth2 client endpoints

docs/datadog_api_client.v2.api.rst

@@ -473,6 +473,13 @@ datadog\_api\_client.v2.api.network\_device\_monitoring\_api module
    :members:
    :show-inheritance:
 
+datadog\_api\_client.v2.api.o\_auth2\_client\_public\_api module
+----------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.api.o_auth2_client_public_api
+   :members:
+   :show-inheritance:
+
 datadog\_api\_client.v2.api.observability\_pipelines\_api module
 ----------------------------------------------------------------
 

docs/datadog_api_client.v2.model.rst

@@ -7872,27 +7872,6 @@ datadog\_api\_client.v2.model.cost\_tag\_metadata\_daily\_filter module
    :members:
    :show-inheritance:
 
-datadog\_api\_client.v2.model.cost\_tag\_metadata\_month module
----------------------------------------------------------------
-
-.. automodule:: datadog_api_client.v2.model.cost_tag_metadata_month
-   :members:
-   :show-inheritance:
-
-datadog\_api\_client.v2.model.cost\_tag\_metadata\_month\_type module
----------------------------------------------------------------------
-
-.. automodule:: datadog_api_client.v2.model.cost_tag_metadata_month_type
-   :members:
-   :show-inheritance:
-
-datadog\_api\_client.v2.model.cost\_tag\_metadata\_months\_response module
---------------------------------------------------------------------------
-
-.. automodule:: datadog_api_client.v2.model.cost_tag_metadata_months_response
-   :members:
-   :show-inheritance:
-
 datadog\_api\_client.v2.model.cost\_tag\_type module
 ----------------------------------------------------
 
@@ -23447,6 +23426,83 @@ datadog\_api\_client.v2.model.nullable\_user\_relationship\_data module
    :members:
    :show-inheritance:
 
+datadog\_api\_client.v2.model.o\_auth\_client\_registration\_error module
+-------------------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.o_auth_client_registration_error
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.o\_auth\_client\_registration\_grant\_type module
+-------------------------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.o_auth_client_registration_grant_type
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.o\_auth\_client\_registration\_request module
+---------------------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.o_auth_client_registration_request
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.o\_auth\_client\_registration\_response module
+----------------------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.o_auth_client_registration_response
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.o\_auth\_client\_registration\_response\_type module
+----------------------------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.o_auth_client_registration_response_type
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.o\_auth\_oidc\_scope module
+---------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.o_auth_oidc_scope
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.o\_auth\_scopes\_restriction module
+-----------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.o_auth_scopes_restriction
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.o\_auth\_scopes\_restriction\_response module
+---------------------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.o_auth_scopes_restriction_response
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.o\_auth\_scopes\_restriction\_response\_attributes module
+---------------------------------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.o_auth_scopes_restriction_response_attributes
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.o\_auth\_scopes\_restriction\_response\_data module
+---------------------------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.o_auth_scopes_restriction_response_data
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.o\_auth\_scopes\_restriction\_type module
+-----------------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.o_auth_scopes_restriction_type
+   :members:
+   :show-inheritance:
+
 datadog\_api\_client.v2.model.observability\_pipeline module
 ------------------------------------------------------------
 
@@ -40240,6 +40296,34 @@ datadog\_api\_client.v2.model.upsert\_cloud\_inventory\_sync\_config\_request\_d
    :members:
    :show-inheritance:
 
+datadog\_api\_client.v2.model.upsert\_o\_auth\_scopes\_restriction\_data module
+-------------------------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.upsert_o_auth_scopes_restriction_data
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.upsert\_o\_auth\_scopes\_restriction\_data\_attributes module
+-------------------------------------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.upsert_o_auth_scopes_restriction_data_attributes
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.upsert\_o\_auth\_scopes\_restriction\_request module
+----------------------------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.upsert_o_auth_scopes_restriction_request
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.upsert\_o\_auth\_scopes\_restriction\_type module
+-------------------------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.upsert_o_auth_scopes_restriction_type
+   :members:
+   :show-inheritance:
+
 datadog\_api\_client.v2.model.urgency module
 --------------------------------------------
 

examples/v2/oauth2-client-public/DeleteScopesRestriction.py

@@ -0,0 +1,15 @@
+"""
+Delete an OAuth2 client scopes restriction returns "No Content" response
+"""
+
+from datadog_api_client import ApiClient, Configuration
+from datadog_api_client.v2.api.o_auth2_client_public_api import OAuth2ClientPublicApi
+from uuid import UUID
+
+configuration = Configuration()
+configuration.unstable_operations["delete_scopes_restriction"] = True
+with ApiClient(configuration) as api_client:
+    api_instance = OAuth2ClientPublicApi(api_client)
+    api_instance.delete_scopes_restriction(
+        client_uuid=UUID("fafa8e1c-36a5-11f0-a83d-da7ad0900001"),
+    )

examples/v2/oauth2-client-public/GetScopesRestriction.py

@@ -0,0 +1,17 @@
+"""
+Get an OAuth2 client scopes restriction returns "OK" response
+"""
+
+from datadog_api_client import ApiClient, Configuration
+from datadog_api_client.v2.api.o_auth2_client_public_api import OAuth2ClientPublicApi
+from uuid import UUID
+
+configuration = Configuration()
+configuration.unstable_operations["get_scopes_restriction"] = True
+with ApiClient(configuration) as api_client:
+    api_instance = OAuth2ClientPublicApi(api_client)
+    response = api_instance.get_scopes_restriction(
+        client_uuid=UUID("fafa8e1c-36a5-11f0-a83d-da7ad0900001"),
+    )
+
+    print(response)

examples/v2/oauth2-client-public/RegisterOAuthClient.py

@@ -0,0 +1,38 @@
+"""
+Register an OAuth2 client returns "Created" response
+"""
+
+from datadog_api_client import ApiClient, Configuration
+from datadog_api_client.v2.api.o_auth2_client_public_api import OAuth2ClientPublicApi
+from datadog_api_client.v2.model.o_auth_client_registration_grant_type import OAuthClientRegistrationGrantType
+from datadog_api_client.v2.model.o_auth_client_registration_request import OAuthClientRegistrationRequest
+from datadog_api_client.v2.model.o_auth_client_registration_response_type import OAuthClientRegistrationResponseType
+
+body = OAuthClientRegistrationRequest(
+    client_name="Example MCP Client",
+    client_uri="https://example.com",
+    grant_types=[
+        OAuthClientRegistrationGrantType.AUTHORIZATION_CODE,
+        OAuthClientRegistrationGrantType.REFRESH_TOKEN,
+    ],
+    jwks_uri="https://example.com/.well-known/jwks.json",
+    logo_uri="https://example.com/logo.png",
+    policy_uri="https://example.com/privacy",
+    redirect_uris=[
+        "https://example.com/oauth/callback",
+    ],
+    response_types=[
+        OAuthClientRegistrationResponseType.CODE,
+    ],
+    scope="openid profile",
+    token_endpoint_auth_method="none",
+    tos_uri="https://example.com/tos",
+)
+
+configuration = Configuration()
+configuration.unstable_operations["register_o_auth_client"] = True
+with ApiClient(configuration) as api_client:
+    api_instance = OAuth2ClientPublicApi(api_client)
+    response = api_instance.register_o_auth_client(body=body)
+
+    print(response)

examples/v2/oauth2-client-public/UpsertScopesRestriction.py

@@ -0,0 +1,40 @@
+"""
+Upsert an OAuth2 client scopes restriction returns "OK" response
+"""
+
+from datadog_api_client import ApiClient, Configuration
+from datadog_api_client.v2.api.o_auth2_client_public_api import OAuth2ClientPublicApi
+from datadog_api_client.v2.model.o_auth_oidc_scope import OAuthOidcScope
+from datadog_api_client.v2.model.upsert_o_auth_scopes_restriction_data import UpsertOAuthScopesRestrictionData
+from datadog_api_client.v2.model.upsert_o_auth_scopes_restriction_data_attributes import (
+    UpsertOAuthScopesRestrictionDataAttributes,
+)
+from datadog_api_client.v2.model.upsert_o_auth_scopes_restriction_request import UpsertOAuthScopesRestrictionRequest
+from datadog_api_client.v2.model.upsert_o_auth_scopes_restriction_type import UpsertOAuthScopesRestrictionType
+from uuid import UUID
+
+body = UpsertOAuthScopesRestrictionRequest(
+    data=UpsertOAuthScopesRestrictionData(
+        attributes=UpsertOAuthScopesRestrictionDataAttributes(
+            oidc_scopes=[
+                OAuthOidcScope.OPENID,
+                OAuthOidcScope.EMAIL,
+            ],
+            permission_scopes=[
+                "dashboards_read",
+                "metrics_read",
+            ],
+        ),
+        type=UpsertOAuthScopesRestrictionType.UPSERT_SCOPES_RESTRICTION,
+    ),
+)
+
+configuration = Configuration()
+configuration.unstable_operations["upsert_scopes_restriction"] = True
+with ApiClient(configuration) as api_client:
+    api_instance = OAuth2ClientPublicApi(api_client)
+    response = api_instance.upsert_scopes_restriction(
+        client_uuid=UUID("fafa8e1c-36a5-11f0-a83d-da7ad0900001"), body=body
+    )
+
+    print(response)

src/datadog_api_client/configuration.py

@@ -445,7 +445,6 @@ def __init__(
                 "v2.list_cost_tag_key_sources": False,
                 "v2.list_cost_tag_metadata": False,
                 "v2.list_cost_tag_metadata_metrics": False,
-                "v2.list_cost_tag_metadata_months": False,
                 "v2.list_cost_tag_metadata_orchestrators": False,
                 "v2.search_cost_recommendations": False,
                 "v2.create_dashboard_secure_embed": False,
@@ -579,6 +578,10 @@ def __init__(
                 "v2.update_monitor_user_template": False,
                 "v2.validate_existing_monitor_user_template": False,
                 "v2.validate_monitor_user_template": False,
+                "v2.delete_scopes_restriction": False,
+                "v2.get_scopes_restriction": False,
+                "v2.register_o_auth_client": False,
+                "v2.upsert_scopes_restriction": False,
                 "v2.bulk_update_org_group_memberships": False,
                 "v2.create_org_group": False,
                 "v2.create_org_group_policy": False,

src/datadog_api_client/v2/api/cloud_cost_management_api.py

@@ -65,7 +65,6 @@
 from datadog_api_client.v2.model.cost_tag_metadata_daily_filter import CostTagMetadataDailyFilter
 from datadog_api_client.v2.model.cost_currency_response import CostCurrencyResponse
 from datadog_api_client.v2.model.cost_metrics_response import CostMetricsResponse
-from datadog_api_client.v2.model.cost_tag_metadata_months_response import CostTagMetadataMonthsResponse
 from datadog_api_client.v2.model.cost_orchestrators_response import CostOrchestratorsResponse
 from datadog_api_client.v2.model.cost_tag_key_sources_response import CostTagKeySourcesResponse
 from datadog_api_client.v2.model.cost_tags_response import CostTagsResponse
@@ -1283,29 +1282,6 @@ def __init__(self, api_client=None):
             api_client=api_client,
         )
 
-        self._list_cost_tag_metadata_months_endpoint = _Endpoint(
-            settings={
-                "response_type": (CostTagMetadataMonthsResponse,),
-                "auth": ["apiKeyAuth", "appKeyAuth", "AuthZ"],
-                "endpoint_path": "/api/v2/cost/tag_metadata/months",
-                "operation_id": "list_cost_tag_metadata_months",
-                "http_method": "GET",
-                "version": "v2",
-            },
-            params_map={
-                "filter_provider": {
-                    "required": True,
-                    "openapi_types": (str,),
-                    "attribute": "filter[provider]",
-                    "location": "query",
-                },
-            },
-            headers_map={
-                "accept": ["application/json"],
-            },
-            api_client=api_client,
-        )
-
         self._list_cost_tag_metadata_orchestrators_endpoint = _Endpoint(
             settings={
                 "response_type": (CostOrchestratorsResponse,),
@@ -2796,27 +2772,6 @@ def list_cost_tag_metadata_metrics(
 
         return self._list_cost_tag_metadata_metrics_endpoint.call_with_http_info(**kwargs)
 
-    def list_cost_tag_metadata_months(
-        self,
-        filter_provider: str,
-    ) -> CostTagMetadataMonthsResponse:
-        """List Cloud Cost Management tag metadata months.
-
-        List months that have Cloud Cost Management tag metadata for a given provider,
-        ordered most-recent first. The response is capped at 36 months.
-
-        :param filter_provider: Provider to scope the query to. Use the value of the ``providername`` tag in CCM
-            (for example, ``aws`` , ``azure`` , ``gcp`` , ``Oracle`` , ``Confluent Cloud`` , ``Snowflake`` ).
-            For costs uploaded through the Custom Costs API, use ``custom``.
-            Values are case-sensitive.
-        :type filter_provider: str
-        :rtype: CostTagMetadataMonthsResponse
-        """
-        kwargs: Dict[str, Any] = {}
-        kwargs["filter_provider"] = filter_provider
-
-        return self._list_cost_tag_metadata_months_endpoint.call_with_http_info(**kwargs)
-
     def list_cost_tag_metadata_orchestrators(
         self,
         filter_month: str,