cribl-control-plane 0.0.31__py3-none-any.whl → 0.0.33__py3-none-any.whl

cribl_control_plane/cribl.py

@@ -0,0 +1,513 @@
+"""Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT."""
+
+from .basesdk import BaseSDK
+from cribl_control_plane import errors, models, utils
+from cribl_control_plane._hooks import HookContext
+from cribl_control_plane.types import OptionalNullable, UNSET
+from cribl_control_plane.utils import get_security_from_env
+from cribl_control_plane.utils.unmarshal_json_response import unmarshal_json_response
+from typing import Any, Mapping, Optional, Union
+
+
+class Cribl(BaseSDK):
+    def list(
+        self,
+        *,
+        retries: OptionalNullable[utils.RetryConfig] = UNSET,
+        server_url: Optional[str] = None,
+        timeout_ms: Optional[int] = None,
+        http_headers: Optional[Mapping[str, str]] = None,
+    ) -> models.GetSystemSettingsConfResponse:
+        r"""Get Cribl system settings
+
+        Get Cribl system settings
+
+        :param retries: Override the default retry configuration for this method
+        :param server_url: Override the default server URL for this method
+        :param timeout_ms: Override the default request timeout configuration for this method in milliseconds
+        :param http_headers: Additional headers to set or replace on requests.
+        """
+        base_url = None
+        url_variables = None
+        if timeout_ms is None:
+            timeout_ms = self.sdk_configuration.timeout_ms
+
+        if server_url is not None:
+            base_url = server_url
+        else:
+            base_url = self._get_url(base_url, url_variables)
+        req = self._build_request(
+            method="GET",
+            path="/system/settings/conf",
+            base_url=base_url,
+            url_variables=url_variables,
+            request=None,
+            request_body_required=False,
+            request_has_path_params=False,
+            request_has_query_params=True,
+            user_agent_header="user-agent",
+            accept_header_value="application/json",
+            http_headers=http_headers,
+            security=self.sdk_configuration.security,
+            timeout_ms=timeout_ms,
+        )
+
+        if retries == UNSET:
+            if self.sdk_configuration.retry_config is not UNSET:
+                retries = self.sdk_configuration.retry_config
+
+        retry_config = None
+        if isinstance(retries, utils.RetryConfig):
+            retry_config = (retries, ["429", "500", "502", "503", "504"])
+
+        http_res = self.do_request(
+            hook_ctx=HookContext(
+                config=self.sdk_configuration,
+                base_url=base_url or "",
+                operation_id="getSystemSettingsConf",
+                oauth2_scopes=[],
+                security_source=get_security_from_env(
+                    self.sdk_configuration.security, models.Security
+                ),
+            ),
+            request=req,
+            error_status_codes=["401", "4XX", "500", "5XX"],
+            retry_config=retry_config,
+        )
+
+        response_data: Any = None
+        if utils.match_response(http_res, "200", "application/json"):
+            return unmarshal_json_response(
+                models.GetSystemSettingsConfResponse, http_res
+            )
+        if utils.match_response(http_res, "500", "application/json"):
+            response_data = unmarshal_json_response(errors.ErrorData, http_res)
+            raise errors.Error(response_data, http_res)
+        if utils.match_response(http_res, ["401", "4XX"], "*"):
+            http_res_text = utils.stream_to_text(http_res)
+            raise errors.APIError("API error occurred", http_res, http_res_text)
+        if utils.match_response(http_res, "5XX", "*"):
+            http_res_text = utils.stream_to_text(http_res)
+            raise errors.APIError("API error occurred", http_res, http_res_text)
+
+        raise errors.APIError("Unexpected response received", http_res)
+
+    async def list_async(
+        self,
+        *,
+        retries: OptionalNullable[utils.RetryConfig] = UNSET,
+        server_url: Optional[str] = None,
+        timeout_ms: Optional[int] = None,
+        http_headers: Optional[Mapping[str, str]] = None,
+    ) -> models.GetSystemSettingsConfResponse:
+        r"""Get Cribl system settings
+
+        Get Cribl system settings
+
+        :param retries: Override the default retry configuration for this method
+        :param server_url: Override the default server URL for this method
+        :param timeout_ms: Override the default request timeout configuration for this method in milliseconds
+        :param http_headers: Additional headers to set or replace on requests.
+        """
+        base_url = None
+        url_variables = None
+        if timeout_ms is None:
+            timeout_ms = self.sdk_configuration.timeout_ms
+
+        if server_url is not None:
+            base_url = server_url
+        else:
+            base_url = self._get_url(base_url, url_variables)
+        req = self._build_request_async(
+            method="GET",
+            path="/system/settings/conf",
+            base_url=base_url,
+            url_variables=url_variables,
+            request=None,
+            request_body_required=False,
+            request_has_path_params=False,
+            request_has_query_params=True,
+            user_agent_header="user-agent",
+            accept_header_value="application/json",
+            http_headers=http_headers,
+            security=self.sdk_configuration.security,
+            timeout_ms=timeout_ms,
+        )
+
+        if retries == UNSET:
+            if self.sdk_configuration.retry_config is not UNSET:
+                retries = self.sdk_configuration.retry_config
+
+        retry_config = None
+        if isinstance(retries, utils.RetryConfig):
+            retry_config = (retries, ["429", "500", "502", "503", "504"])
+
+        http_res = await self.do_request_async(
+            hook_ctx=HookContext(
+                config=self.sdk_configuration,
+                base_url=base_url or "",
+                operation_id="getSystemSettingsConf",
+                oauth2_scopes=[],
+                security_source=get_security_from_env(
+                    self.sdk_configuration.security, models.Security
+                ),
+            ),
+            request=req,
+            error_status_codes=["401", "4XX", "500", "5XX"],
+            retry_config=retry_config,
+        )
+
+        response_data: Any = None
+        if utils.match_response(http_res, "200", "application/json"):
+            return unmarshal_json_response(
+                models.GetSystemSettingsConfResponse, http_res
+            )
+        if utils.match_response(http_res, "500", "application/json"):
+            response_data = unmarshal_json_response(errors.ErrorData, http_res)
+            raise errors.Error(response_data, http_res)
+        if utils.match_response(http_res, ["401", "4XX"], "*"):
+            http_res_text = await utils.stream_to_text_async(http_res)
+            raise errors.APIError("API error occurred", http_res, http_res_text)
+        if utils.match_response(http_res, "5XX", "*"):
+            http_res_text = await utils.stream_to_text_async(http_res)
+            raise errors.APIError("API error occurred", http_res, http_res_text)
+
+        raise errors.APIError("Unexpected response received", http_res)
+
+    def update(
+        self,
+        *,
+        api: Union[models.SystemSettingsConfAPI, models.SystemSettingsConfAPITypedDict],
+        backups: Union[
+            models.SystemSettingsConfBackups, models.SystemSettingsConfBackupsTypedDict
+        ],
+        custom_logo: Union[
+            models.SystemSettingsConfCustomLogo,
+            models.SystemSettingsConfCustomLogoTypedDict,
+        ],
+        pii: Union[models.SystemSettingsConfPii, models.SystemSettingsConfPiiTypedDict],
+        proxy: Union[
+            models.SystemSettingsConfProxy, models.SystemSettingsConfProxyTypedDict
+        ],
+        rollback: Union[
+            models.SystemSettingsConfRollback,
+            models.SystemSettingsConfRollbackTypedDict,
+        ],
+        shutdown: Union[
+            models.SystemSettingsConfShutdown,
+            models.SystemSettingsConfShutdownTypedDict,
+        ],
+        sni: Union[models.SystemSettingsConfSni, models.SystemSettingsConfSniTypedDict],
+        system: Union[
+            models.SystemSettingsConfSystem, models.SystemSettingsConfSystemTypedDict
+        ],
+        tls: Union[models.SystemSettingsConfTLS, models.SystemSettingsConfTLSTypedDict],
+        upgrade_group_settings: Union[
+            models.UpgradeGroupSettings, models.UpgradeGroupSettingsTypedDict
+        ],
+        upgrade_settings: Union[
+            models.UpgradeSettings, models.UpgradeSettingsTypedDict
+        ],
+        workers: Union[
+            models.SystemSettingsConfWorkers, models.SystemSettingsConfWorkersTypedDict
+        ],
+        sockets: Optional[
+            Union[
+                models.SystemSettingsConfSockets,
+                models.SystemSettingsConfSocketsTypedDict,
+            ]
+        ] = None,
+        retries: OptionalNullable[utils.RetryConfig] = UNSET,
+        server_url: Optional[str] = None,
+        timeout_ms: Optional[int] = None,
+        http_headers: Optional[Mapping[str, str]] = None,
+    ) -> models.UpdateSystemSettingsConfResponse:
+        r"""Update Cribl system settings
+
+        Update Cribl system settings
+
+        :param api:
+        :param backups:
+        :param custom_logo:
+        :param pii:
+        :param proxy:
+        :param rollback:
+        :param shutdown:
+        :param sni:
+        :param system:
+        :param tls:
+        :param upgrade_group_settings:
+        :param upgrade_settings:
+        :param workers:
+        :param sockets:
+        :param retries: Override the default retry configuration for this method
+        :param server_url: Override the default server URL for this method
+        :param timeout_ms: Override the default request timeout configuration for this method in milliseconds
+        :param http_headers: Additional headers to set or replace on requests.
+        """
+        base_url = None
+        url_variables = None
+        if timeout_ms is None:
+            timeout_ms = self.sdk_configuration.timeout_ms
+
+        if server_url is not None:
+            base_url = server_url
+        else:
+            base_url = self._get_url(base_url, url_variables)
+
+        request = models.SystemSettingsConf(
+            api=utils.get_pydantic_model(api, models.SystemSettingsConfAPI),
+            backups=utils.get_pydantic_model(backups, models.SystemSettingsConfBackups),
+            custom_logo=utils.get_pydantic_model(
+                custom_logo, models.SystemSettingsConfCustomLogo
+            ),
+            pii=utils.get_pydantic_model(pii, models.SystemSettingsConfPii),
+            proxy=utils.get_pydantic_model(proxy, models.SystemSettingsConfProxy),
+            rollback=utils.get_pydantic_model(
+                rollback, models.SystemSettingsConfRollback
+            ),
+            shutdown=utils.get_pydantic_model(
+                shutdown, models.SystemSettingsConfShutdown
+            ),
+            sni=utils.get_pydantic_model(sni, models.SystemSettingsConfSni),
+            sockets=utils.get_pydantic_model(
+                sockets, Optional[models.SystemSettingsConfSockets]
+            ),
+            system=utils.get_pydantic_model(system, models.SystemSettingsConfSystem),
+            tls=utils.get_pydantic_model(tls, models.SystemSettingsConfTLS),
+            upgrade_group_settings=utils.get_pydantic_model(
+                upgrade_group_settings, models.UpgradeGroupSettings
+            ),
+            upgrade_settings=utils.get_pydantic_model(
+                upgrade_settings, models.UpgradeSettings
+            ),
+            workers=utils.get_pydantic_model(workers, models.SystemSettingsConfWorkers),
+        )
+
+        req = self._build_request(
+            method="PATCH",
+            path="/system/settings/conf",
+            base_url=base_url,
+            url_variables=url_variables,
+            request=request,
+            request_body_required=True,
+            request_has_path_params=False,
+            request_has_query_params=True,
+            user_agent_header="user-agent",
+            accept_header_value="application/json",
+            http_headers=http_headers,
+            security=self.sdk_configuration.security,
+            get_serialized_body=lambda: utils.serialize_request_body(
+                request, False, False, "json", models.SystemSettingsConf
+            ),
+            timeout_ms=timeout_ms,
+        )
+
+        if retries == UNSET:
+            if self.sdk_configuration.retry_config is not UNSET:
+                retries = self.sdk_configuration.retry_config
+
+        retry_config = None
+        if isinstance(retries, utils.RetryConfig):
+            retry_config = (retries, ["429", "500", "502", "503", "504"])
+
+        http_res = self.do_request(
+            hook_ctx=HookContext(
+                config=self.sdk_configuration,
+                base_url=base_url or "",
+                operation_id="updateSystemSettingsConf",
+                oauth2_scopes=[],
+                security_source=get_security_from_env(
+                    self.sdk_configuration.security, models.Security
+                ),
+            ),
+            request=req,
+            error_status_codes=["401", "4XX", "500", "5XX"],
+            retry_config=retry_config,
+        )
+
+        response_data: Any = None
+        if utils.match_response(http_res, "200", "application/json"):
+            return unmarshal_json_response(
+                models.UpdateSystemSettingsConfResponse, http_res
+            )
+        if utils.match_response(http_res, "500", "application/json"):
+            response_data = unmarshal_json_response(errors.ErrorData, http_res)
+            raise errors.Error(response_data, http_res)
+        if utils.match_response(http_res, ["401", "4XX"], "*"):
+            http_res_text = utils.stream_to_text(http_res)
+            raise errors.APIError("API error occurred", http_res, http_res_text)
+        if utils.match_response(http_res, "5XX", "*"):
+            http_res_text = utils.stream_to_text(http_res)
+            raise errors.APIError("API error occurred", http_res, http_res_text)
+
+        raise errors.APIError("Unexpected response received", http_res)
+
+    async def update_async(
+        self,
+        *,
+        api: Union[models.SystemSettingsConfAPI, models.SystemSettingsConfAPITypedDict],
+        backups: Union[
+            models.SystemSettingsConfBackups, models.SystemSettingsConfBackupsTypedDict
+        ],
+        custom_logo: Union[
+            models.SystemSettingsConfCustomLogo,
+            models.SystemSettingsConfCustomLogoTypedDict,
+        ],
+        pii: Union[models.SystemSettingsConfPii, models.SystemSettingsConfPiiTypedDict],
+        proxy: Union[
+            models.SystemSettingsConfProxy, models.SystemSettingsConfProxyTypedDict
+        ],
+        rollback: Union[
+            models.SystemSettingsConfRollback,
+            models.SystemSettingsConfRollbackTypedDict,
+        ],
+        shutdown: Union[
+            models.SystemSettingsConfShutdown,
+            models.SystemSettingsConfShutdownTypedDict,
+        ],
+        sni: Union[models.SystemSettingsConfSni, models.SystemSettingsConfSniTypedDict],
+        system: Union[
+            models.SystemSettingsConfSystem, models.SystemSettingsConfSystemTypedDict
+        ],
+        tls: Union[models.SystemSettingsConfTLS, models.SystemSettingsConfTLSTypedDict],
+        upgrade_group_settings: Union[
+            models.UpgradeGroupSettings, models.UpgradeGroupSettingsTypedDict
+        ],
+        upgrade_settings: Union[
+            models.UpgradeSettings, models.UpgradeSettingsTypedDict
+        ],
+        workers: Union[
+            models.SystemSettingsConfWorkers, models.SystemSettingsConfWorkersTypedDict
+        ],
+        sockets: Optional[
+            Union[
+                models.SystemSettingsConfSockets,
+                models.SystemSettingsConfSocketsTypedDict,
+            ]
+        ] = None,
+        retries: OptionalNullable[utils.RetryConfig] = UNSET,
+        server_url: Optional[str] = None,
+        timeout_ms: Optional[int] = None,
+        http_headers: Optional[Mapping[str, str]] = None,
+    ) -> models.UpdateSystemSettingsConfResponse:
+        r"""Update Cribl system settings
+
+        Update Cribl system settings
+
+        :param api:
+        :param backups:
+        :param custom_logo:
+        :param pii:
+        :param proxy:
+        :param rollback:
+        :param shutdown:
+        :param sni:
+        :param system:
+        :param tls:
+        :param upgrade_group_settings:
+        :param upgrade_settings:
+        :param workers:
+        :param sockets:
+        :param retries: Override the default retry configuration for this method
+        :param server_url: Override the default server URL for this method
+        :param timeout_ms: Override the default request timeout configuration for this method in milliseconds
+        :param http_headers: Additional headers to set or replace on requests.
+        """
+        base_url = None
+        url_variables = None
+        if timeout_ms is None:
+            timeout_ms = self.sdk_configuration.timeout_ms
+
+        if server_url is not None:
+            base_url = server_url
+        else:
+            base_url = self._get_url(base_url, url_variables)
+
+        request = models.SystemSettingsConf(
+            api=utils.get_pydantic_model(api, models.SystemSettingsConfAPI),
+            backups=utils.get_pydantic_model(backups, models.SystemSettingsConfBackups),
+            custom_logo=utils.get_pydantic_model(
+                custom_logo, models.SystemSettingsConfCustomLogo
+            ),
+            pii=utils.get_pydantic_model(pii, models.SystemSettingsConfPii),
+            proxy=utils.get_pydantic_model(proxy, models.SystemSettingsConfProxy),
+            rollback=utils.get_pydantic_model(
+                rollback, models.SystemSettingsConfRollback
+            ),
+            shutdown=utils.get_pydantic_model(
+                shutdown, models.SystemSettingsConfShutdown
+            ),
+            sni=utils.get_pydantic_model(sni, models.SystemSettingsConfSni),
+            sockets=utils.get_pydantic_model(
+                sockets, Optional[models.SystemSettingsConfSockets]
+            ),
+            system=utils.get_pydantic_model(system, models.SystemSettingsConfSystem),
+            tls=utils.get_pydantic_model(tls, models.SystemSettingsConfTLS),
+            upgrade_group_settings=utils.get_pydantic_model(
+                upgrade_group_settings, models.UpgradeGroupSettings
+            ),
+            upgrade_settings=utils.get_pydantic_model(
+                upgrade_settings, models.UpgradeSettings
+            ),
+            workers=utils.get_pydantic_model(workers, models.SystemSettingsConfWorkers),
+        )
+
+        req = self._build_request_async(
+            method="PATCH",
+            path="/system/settings/conf",
+            base_url=base_url,
+            url_variables=url_variables,
+            request=request,
+            request_body_required=True,
+            request_has_path_params=False,
+            request_has_query_params=True,
+            user_agent_header="user-agent",
+            accept_header_value="application/json",
+            http_headers=http_headers,
+            security=self.sdk_configuration.security,
+            get_serialized_body=lambda: utils.serialize_request_body(
+                request, False, False, "json", models.SystemSettingsConf
+            ),
+            timeout_ms=timeout_ms,
+        )
+
+        if retries == UNSET:
+            if self.sdk_configuration.retry_config is not UNSET:
+                retries = self.sdk_configuration.retry_config
+
+        retry_config = None
+        if isinstance(retries, utils.RetryConfig):
+            retry_config = (retries, ["429", "500", "502", "503", "504"])
+
+        http_res = await self.do_request_async(
+            hook_ctx=HookContext(
+                config=self.sdk_configuration,
+                base_url=base_url or "",
+                operation_id="updateSystemSettingsConf",
+                oauth2_scopes=[],
+                security_source=get_security_from_env(
+                    self.sdk_configuration.security, models.Security
+                ),
+            ),
+            request=req,
+            error_status_codes=["401", "4XX", "500", "5XX"],
+            retry_config=retry_config,
+        )
+
+        response_data: Any = None
+        if utils.match_response(http_res, "200", "application/json"):
+            return unmarshal_json_response(
+                models.UpdateSystemSettingsConfResponse, http_res
+            )
+        if utils.match_response(http_res, "500", "application/json"):
+            response_data = unmarshal_json_response(errors.ErrorData, http_res)
+            raise errors.Error(response_data, http_res)
+        if utils.match_response(http_res, ["401", "4XX"], "*"):
+            http_res_text = await utils.stream_to_text_async(http_res)
+            raise errors.APIError("API error occurred", http_res, http_res_text)
+        if utils.match_response(http_res, "5XX", "*"):
+            http_res_text = await utils.stream_to_text_async(http_res)
+            raise errors.APIError("API error occurred", http_res, http_res_text)
+
+        raise errors.APIError("Unexpected response received", http_res)

cribl_control_plane/destinations.py

@@ -5,7 +5,7 @@ from .sdkconfiguration import SDKConfiguration
 from cribl_control_plane import errors, models, utils
 from cribl_control_plane._hooks import HookContext
 from cribl_control_plane.destinations_pq import DestinationsPq
-from cribl_control_plane.samples import Samples
+from cribl_control_plane.destinations_samples import DestinationsSamples
 from cribl_control_plane.types import BaseModel, OptionalNullable, UNSET
 from cribl_control_plane.utils import get_security_from_env
 from cribl_control_plane.utils.unmarshal_json_response import unmarshal_json_response
@@ -16,7 +16,7 @@ class Destinations(BaseSDK):
     r"""Actions related to Destinations"""
 
     pq: DestinationsPq
-    samples: Samples
+    samples: DestinationsSamples
 
     def __init__(self, sdk_config: SDKConfiguration) -> None:
         BaseSDK.__init__(self, sdk_config)
@@ -25,7 +25,7 @@ class Destinations(BaseSDK):
 
     def _init_sdks(self):
         self.pq = DestinationsPq(self.sdk_configuration)
-        self.samples = Samples(self.sdk_configuration)
+        self.samples = DestinationsSamples(self.sdk_configuration)
 
     def list(
         self,
@@ -37,7 +37,7 @@ class Destinations(BaseSDK):
     ) -> models.ListOutputResponse:
         r"""List all Destinations
 
-        Get a list of Destination objects
+        Get a list of all Destinations.
 
         :param retries: Override the default retry configuration for this method
         :param server_url: Override the default server URL for this method
@@ -117,7 +117,7 @@ class Destinations(BaseSDK):
     ) -> models.ListOutputResponse:
         r"""List all Destinations
 
-        Get a list of Destination objects
+        Get a list of all Destinations.
 
         :param retries: Override the default retry configuration for this method
         :param server_url: Override the default server URL for this method
@@ -198,7 +198,7 @@ class Destinations(BaseSDK):
     ) -> models.CreateOutputResponse:
         r"""Create a Destination
 
-        Create Destination
+        Create a new Destination.
 
         :param request: The request object to send.
         :param retries: Override the default retry configuration for this method
@@ -288,7 +288,7 @@ class Destinations(BaseSDK):
     ) -> models.CreateOutputResponse:
         r"""Create a Destination
 
-        Create Destination
+        Create a new Destination.
 
         :param request: The request object to send.
         :param retries: Override the default retry configuration for this method
@@ -376,11 +376,11 @@ class Destinations(BaseSDK):
         timeout_ms: Optional[int] = None,
         http_headers: Optional[Mapping[str, str]] = None,
     ) -> models.GetOutputByIDResponse:
-        r"""Retrieve a Destination
+        r"""Get a Destination
 
-        Get Destination by ID
+        Get the specified Destination.
 
-        :param id: Unique ID to GET
+        :param id: The <code>id</code> of the Destination to get.
         :param retries: Override the default retry configuration for this method
         :param server_url: Override the default server URL for this method
         :param timeout_ms: Override the default request timeout configuration for this method in milliseconds
@@ -463,11 +463,11 @@ class Destinations(BaseSDK):
         timeout_ms: Optional[int] = None,
         http_headers: Optional[Mapping[str, str]] = None,
     ) -> models.GetOutputByIDResponse:
-        r"""Retrieve a Destination
+        r"""Get a Destination
 
-        Get Destination by ID
+        Get the specified Destination.
 
-        :param id: Unique ID to GET
+        :param id: The <code>id</code> of the Destination to get.
         :param retries: Override the default retry configuration for this method
         :param server_url: Override the default server URL for this method
         :param timeout_ms: Override the default request timeout configuration for this method in milliseconds
@@ -553,9 +553,9 @@ class Destinations(BaseSDK):
     ) -> models.UpdateOutputByIDResponse:
         r"""Update a Destination
 
-        Update Destination
+        Update the specified Destination.</br></br>Provide a complete representation of the Destination that you want to update in the request body. This endpoint does not support partial updates. Cribl removes any omitted fields when updating the Destination.</br></br>Confirm that the configuration in your request body is correct before sending the request. If the configuration is incorrect, the updated Destination might not function as expected.
 
-        :param id: Unique ID to PATCH
+        :param id: The <code>id</code> of the Destination to update.
         :param output: Output object
         :param retries: Override the default retry configuration for this method
         :param server_url: Override the default server URL for this method
@@ -646,9 +646,9 @@ class Destinations(BaseSDK):
     ) -> models.UpdateOutputByIDResponse:
         r"""Update a Destination
 
-        Update Destination
+        Update the specified Destination.</br></br>Provide a complete representation of the Destination that you want to update in the request body. This endpoint does not support partial updates. Cribl removes any omitted fields when updating the Destination.</br></br>Confirm that the configuration in your request body is correct before sending the request. If the configuration is incorrect, the updated Destination might not function as expected.
 
-        :param id: Unique ID to PATCH
+        :param id: The <code>id</code> of the Destination to update.
         :param output: Output object
         :param retries: Override the default retry configuration for this method
         :param server_url: Override the default server URL for this method
@@ -738,9 +738,9 @@ class Destinations(BaseSDK):
     ) -> models.DeleteOutputByIDResponse:
         r"""Delete a Destination
 
-        Delete Destination
+        Delete the specified Destination.
 
-        :param id: Unique ID to DELETE
+        :param id: The <code>id</code> of the Destination to delete.
         :param retries: Override the default retry configuration for this method
         :param server_url: Override the default server URL for this method
         :param timeout_ms: Override the default request timeout configuration for this method in milliseconds
@@ -825,9 +825,9 @@ class Destinations(BaseSDK):
     ) -> models.DeleteOutputByIDResponse:
         r"""Delete a Destination
 
-        Delete Destination
+        Delete the specified Destination.
 
-        :param id: Unique ID to DELETE
+        :param id: The <code>id</code> of the Destination to delete.
         :param retries: Override the default retry configuration for this method
         :param server_url: Override the default server URL for this method
         :param timeout_ms: Override the default request timeout configuration for this method in milliseconds