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

cribl_control_plane/models/getversionfilesop.py

@@ -11,9 +11,9 @@ from typing_extensions import Annotated, NotRequired, TypedDict
 
 class GetVersionFilesRequestTypedDict(TypedDict):
     group: NotRequired[str]
-    r"""Group ID"""
+    r"""The <code>id</code> of the Worker Group or Edge Fleet to get file names and status for."""
     id: NotRequired[str]
-    r"""Commit ID"""
+    r"""The Git commit hash to use as the starting point for the request."""
 
 
 class GetVersionFilesRequest(BaseModel):
@@ -21,14 +21,14 @@ class GetVersionFilesRequest(BaseModel):
         Optional[str],
         FieldMetadata(query=QueryParamMetadata(style="form", explode=True)),
     ] = None
-    r"""Group ID"""
+    r"""The <code>id</code> of the Worker Group or Edge Fleet to get file names and status for."""
 
     id: Annotated[
         Optional[str],
         pydantic.Field(alias="ID"),
         FieldMetadata(query=QueryParamMetadata(style="form", explode=True)),
     ] = None
-    r"""Commit ID"""
+    r"""The Git commit hash to use as the starting point for the request."""
 
 
 class GetVersionFilesResponseTypedDict(TypedDict):

cribl_control_plane/models/getversionshowop.py

@@ -10,13 +10,13 @@ from typing_extensions import Annotated, NotRequired, TypedDict
 
 class GetVersionShowRequestTypedDict(TypedDict):
     commit: NotRequired[str]
-    r"""Commit hash (default is HEAD)"""
+    r"""The Git commit hash to retrieve the diff and log message for."""
     group: NotRequired[str]
-    r"""Group ID"""
+    r"""The <code>id</code> of the Worker Group or Edge Fleet to get the diff and log message for."""
     filename: NotRequired[str]
-    r"""Filename"""
+    r"""The relative path of the file to get the diff and log message for."""
     diff_line_limit: NotRequired[float]
-    r"""Limit maximum lines in the diff"""
+    r"""Number of lines of the diff to return. Default is 1000. Set to <code>0</code> to return the full diff, regardless of the number of lines."""
 
 
 class GetVersionShowRequest(BaseModel):
@@ -24,26 +24,26 @@ class GetVersionShowRequest(BaseModel):
         Optional[str],
         FieldMetadata(query=QueryParamMetadata(style="form", explode=True)),
     ] = None
-    r"""Commit hash (default is HEAD)"""
+    r"""The Git commit hash to retrieve the diff and log message for."""
 
     group: Annotated[
         Optional[str],
         FieldMetadata(query=QueryParamMetadata(style="form", explode=True)),
     ] = None
-    r"""Group ID"""
+    r"""The <code>id</code> of the Worker Group or Edge Fleet to get the diff and log message for."""
 
     filename: Annotated[
         Optional[str],
         FieldMetadata(query=QueryParamMetadata(style="form", explode=True)),
     ] = None
-    r"""Filename"""
+    r"""The relative path of the file to get the diff and log message for."""
 
     diff_line_limit: Annotated[
         Optional[float],
         pydantic.Field(alias="diffLineLimit"),
         FieldMetadata(query=QueryParamMetadata(style="form", explode=True)),
     ] = None
-    r"""Limit maximum lines in the diff"""
+    r"""Number of lines of the diff to return. Default is 1000. Set to <code>0</code> to return the full diff, regardless of the number of lines."""
 
 
 class GetVersionShowResponseTypedDict(TypedDict):

cribl_control_plane/models/getversionstatusop.py

@@ -10,7 +10,7 @@ from typing_extensions import Annotated, NotRequired, TypedDict
 
 class GetVersionStatusRequestTypedDict(TypedDict):
     group: NotRequired[str]
-    r"""Group ID"""
+    r"""The <code>id</code> of the Worker Group or Edge Fleet to get the status for."""
 
 
 class GetVersionStatusRequest(BaseModel):
@@ -18,7 +18,7 @@ class GetVersionStatusRequest(BaseModel):
         Optional[str],
         FieldMetadata(query=QueryParamMetadata(style="form", explode=True)),
     ] = None
-    r"""Group ID"""
+    r"""The <code>id</code> of the Worker Group or Edge Fleet to get the status for."""
 
 
 class GetVersionStatusResponseTypedDict(TypedDict):

cribl_control_plane/models/listmasterworkerentryop.py

@@ -11,17 +11,17 @@ from typing_extensions import Annotated, NotRequired, TypedDict
 
 class ListMasterWorkerEntryRequestTypedDict(TypedDict):
     filter_exp: NotRequired[str]
-    r"""Filter expression evaluated against nodes"""
-    sort: NotRequired[str]
-    r"""Sorting object (JSON stringified) expression evaluated against nodes"""
+    r"""Filter expression to evaluate against Nodes for inclusion in the response."""
     sort_exp: NotRequired[str]
-    r"""Sorting expression evaluated against nodes"""
+    r"""Sorting expression to evaluate against Nodes to specify the sort order for the response."""
+    filter_: NotRequired[str]
+    r"""JSON-stringified filter object to evaluate against Nodes for inclusion in the response."""
+    sort: NotRequired[str]
+    r"""JSON-stringified sorting object to evaluate against Nodes to specify the sort order for the response."""
     limit: NotRequired[int]
-    r"""Maximum number of nodes to return"""
+    r"""Maximum number of Nodes to return in the response for this request. Use with <code>offset</code> to paginate the response into manageable batches."""
     offset: NotRequired[int]
-    r"""Pagination offset"""
-    filter_: NotRequired[str]
-    r"""Filter object (JSON stringified) to select nodes"""
+    r"""Starting point from which to retrieve results for this request. Use with <code>limit</code> to paginate the response into manageable batches."""
 
 
 class ListMasterWorkerEntryRequest(BaseModel):
@@ -30,39 +30,39 @@ class ListMasterWorkerEntryRequest(BaseModel):
         pydantic.Field(alias="filterExp"),
         FieldMetadata(query=QueryParamMetadata(style="form", explode=True)),
     ] = None
-    r"""Filter expression evaluated against nodes"""
+    r"""Filter expression to evaluate against Nodes for inclusion in the response."""
 
-    sort: Annotated[
+    sort_exp: Annotated[
         Optional[str],
+        pydantic.Field(alias="sortExp"),
         FieldMetadata(query=QueryParamMetadata(style="form", explode=True)),
     ] = None
-    r"""Sorting object (JSON stringified) expression evaluated against nodes"""
+    r"""Sorting expression to evaluate against Nodes to specify the sort order for the response."""
 
-    sort_exp: Annotated[
+    filter_: Annotated[
         Optional[str],
-        pydantic.Field(alias="sortExp"),
+        pydantic.Field(alias="filter"),
         FieldMetadata(query=QueryParamMetadata(style="form", explode=True)),
     ] = None
-    r"""Sorting expression evaluated against nodes"""
+    r"""JSON-stringified filter object to evaluate against Nodes for inclusion in the response."""
 
-    limit: Annotated[
-        Optional[int],
+    sort: Annotated[
+        Optional[str],
         FieldMetadata(query=QueryParamMetadata(style="form", explode=True)),
     ] = None
-    r"""Maximum number of nodes to return"""
+    r"""JSON-stringified sorting object to evaluate against Nodes to specify the sort order for the response."""
 
-    offset: Annotated[
+    limit: Annotated[
         Optional[int],
         FieldMetadata(query=QueryParamMetadata(style="form", explode=True)),
     ] = None
-    r"""Pagination offset"""
+    r"""Maximum number of Nodes to return in the response for this request. Use with <code>offset</code> to paginate the response into manageable batches."""
 
-    filter_: Annotated[
-        Optional[str],
-        pydantic.Field(alias="filter"),
+    offset: Annotated[
+        Optional[int],
         FieldMetadata(query=QueryParamMetadata(style="form", explode=True)),
     ] = None
-    r"""Filter object (JSON stringified) to select nodes"""
+    r"""Starting point from which to retrieve results for this request. Use with <code>limit</code> to paginate the response into manageable batches."""
 
 
 class ListMasterWorkerEntryResponseTypedDict(TypedDict):

cribl_control_plane/models/updatecribllakedatasetbylakeidandidop.py

@@ -11,9 +11,9 @@ from typing_extensions import Annotated, NotRequired, TypedDict
 
 class UpdateCriblLakeDatasetByLakeIDAndIDRequestTypedDict(TypedDict):
     lake_id: str
-    r"""lake id that contains the Datasets"""
+    r"""The <code>id</code> of the Lake that contains the Lake Dataset to update."""
     id_param: str
-    r"""dataset id to update"""
+    r"""The <code>id</code> of the Lake Dataset to update."""
     cribl_lake_dataset: CriblLakeDatasetTypedDict
     r"""CriblLakeDataset object"""
 
@@ -24,14 +24,14 @@ class UpdateCriblLakeDatasetByLakeIDAndIDRequest(BaseModel):
         pydantic.Field(alias="lakeId"),
         FieldMetadata(path=PathParamMetadata(style="simple", explode=False)),
     ]
-    r"""lake id that contains the Datasets"""
+    r"""The <code>id</code> of the Lake that contains the Lake Dataset to update."""
 
     id_param: Annotated[
         str,
         pydantic.Field(alias="id"),
         FieldMetadata(path=PathParamMetadata(style="simple", explode=False)),
     ]
-    r"""dataset id to update"""
+    r"""The <code>id</code> of the Lake Dataset to update."""
 
     cribl_lake_dataset: Annotated[
         CriblLakeDataset,

cribl_control_plane/models/updateinputbyidop.py

@@ -10,7 +10,7 @@ from typing_extensions import Annotated, NotRequired, TypedDict
 
 class UpdateInputByIDRequestTypedDict(TypedDict):
     id: str
-    r"""Unique ID to PATCH"""
+    r"""The <code>id</code> of the Source to update."""
     input: InputTypedDict
     r"""Input object"""
 
@@ -19,7 +19,7 @@ class UpdateInputByIDRequest(BaseModel):
     id: Annotated[
         str, FieldMetadata(path=PathParamMetadata(style="simple", explode=False))
     ]
-    r"""Unique ID to PATCH"""
+    r"""The <code>id</code> of the Source to update."""
 
     input: Annotated[
         Input, FieldMetadata(request=RequestMetadata(media_type="application/json"))

cribl_control_plane/models/updateinputhectokenbyidandtokenop.py

@@ -10,9 +10,9 @@ from typing_extensions import Annotated, NotRequired, TypedDict
 
 class UpdateInputHecTokenByIDAndTokenRequestTypedDict(TypedDict):
     id: str
-    r"""HEC Source id"""
+    r"""The <code>id</code> of the Splunk HEC Source."""
     token: str
-    r"""token to update"""
+    r"""The <code>id</code> of the HEC token to update."""
     update_hec_token_request: UpdateHecTokenRequestTypedDict
     r"""UpdateHecTokenRequest object"""
 
@@ -21,12 +21,12 @@ class UpdateInputHecTokenByIDAndTokenRequest(BaseModel):
     id: Annotated[
         str, FieldMetadata(path=PathParamMetadata(style="simple", explode=False))
     ]
-    r"""HEC Source id"""
+    r"""The <code>id</code> of the Splunk HEC Source."""
 
     token: Annotated[
         str, FieldMetadata(path=PathParamMetadata(style="simple", explode=False))
     ]
-    r"""token to update"""
+    r"""The <code>id</code> of the HEC token to update."""
 
     update_hec_token_request: Annotated[
         UpdateHecTokenRequest,

cribl_control_plane/models/updateoutputbyidop.py

@@ -10,7 +10,7 @@ from typing_extensions import Annotated, NotRequired, TypedDict
 
 class UpdateOutputByIDRequestTypedDict(TypedDict):
     id: str
-    r"""Unique ID to PATCH"""
+    r"""The <code>id</code> of the Destination to update."""
     output: OutputTypedDict
     r"""Output object"""
 
@@ -19,7 +19,7 @@ class UpdateOutputByIDRequest(BaseModel):
     id: Annotated[
         str, FieldMetadata(path=PathParamMetadata(style="simple", explode=False))
     ]
-    r"""Unique ID to PATCH"""
+    r"""The <code>id</code> of the Destination to update."""
 
     output: Annotated[
         Output, FieldMetadata(request=RequestMetadata(media_type="application/json"))

cribl_control_plane/models/updatepacksbyidop.py

@@ -14,7 +14,7 @@ from typing_extensions import Annotated, NotRequired, TypedDict
 
 class UpdatePacksByIDRequestTypedDict(TypedDict):
     id: str
-    r"""Pack name"""
+    r"""The <code>id</code> of the Pack to upgrade."""
     source: NotRequired[str]
     r"""body string required Pack source"""
     minor: NotRequired[str]
@@ -27,7 +27,7 @@ class UpdatePacksByIDRequest(BaseModel):
     id: Annotated[
         str, FieldMetadata(path=PathParamMetadata(style="simple", explode=False))
     ]
-    r"""Pack name"""
+    r"""The <code>id</code> of the Pack to upgrade."""
 
     source: Annotated[
         Optional[str],

cribl_control_plane/nodes.py

@@ -26,26 +26,26 @@ class Nodes(BaseSDK):
         self,
         *,
         filter_exp: Optional[str] = None,
-        sort: Optional[str] = None,
         sort_exp: Optional[str] = None,
+        filter_: Optional[str] = None,
+        sort: Optional[str] = None,
         limit: Optional[int] = None,
         offset: Optional[int] = None,
-        filter_: Optional[str] = None,
         retries: OptionalNullable[utils.RetryConfig] = UNSET,
         server_url: Optional[str] = None,
         timeout_ms: Optional[int] = None,
         http_headers: Optional[Mapping[str, str]] = None,
     ) -> models.ListMasterWorkerEntryResponse:
-        r"""Retrieve detailed metadata for Worker and Edge Nodes
+        r"""Get detailed metadata for Worker and Edge Nodes
 
-        get worker and edge nodes
+        Get detailed metadata for Worker and Edge Nodes.
 
-        :param filter_exp: Filter expression evaluated against nodes
-        :param sort: Sorting object (JSON stringified) expression evaluated against nodes
-        :param sort_exp: Sorting expression evaluated against nodes
-        :param limit: Maximum number of nodes to return
-        :param offset: Pagination offset
-        :param filter_: Filter object (JSON stringified) to select nodes
+        :param filter_exp: Filter expression to evaluate against Nodes for inclusion in the response.
+        :param sort_exp: Sorting expression to evaluate against Nodes to specify the sort order for the response.
+        :param filter_: JSON-stringified filter object to evaluate against Nodes for inclusion in the response.
+        :param sort: JSON-stringified sorting object to evaluate against Nodes to specify the sort order for the response.
+        :param limit: Maximum number of Nodes to return in the response for this request. Use with <code>offset</code> to paginate the response into manageable batches.
+        :param offset: Starting point from which to retrieve results for this request. Use with <code>limit</code> to paginate the response into manageable batches.
         :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
@@ -63,11 +63,11 @@ class Nodes(BaseSDK):
 
         request = models.ListMasterWorkerEntryRequest(
             filter_exp=filter_exp,
-            sort=sort,
             sort_exp=sort_exp,
+            filter_=filter_,
+            sort=sort,
             limit=limit,
             offset=offset,
-            filter_=filter_,
         )
 
         req = self._build_request(
@@ -130,26 +130,26 @@ class Nodes(BaseSDK):
         self,
         *,
         filter_exp: Optional[str] = None,
-        sort: Optional[str] = None,
         sort_exp: Optional[str] = None,
+        filter_: Optional[str] = None,
+        sort: Optional[str] = None,
         limit: Optional[int] = None,
         offset: Optional[int] = None,
-        filter_: Optional[str] = None,
         retries: OptionalNullable[utils.RetryConfig] = UNSET,
         server_url: Optional[str] = None,
         timeout_ms: Optional[int] = None,
         http_headers: Optional[Mapping[str, str]] = None,
     ) -> models.ListMasterWorkerEntryResponse:
-        r"""Retrieve detailed metadata for Worker and Edge Nodes
+        r"""Get detailed metadata for Worker and Edge Nodes
 
-        get worker and edge nodes
+        Get detailed metadata for Worker and Edge Nodes.
 
-        :param filter_exp: Filter expression evaluated against nodes
-        :param sort: Sorting object (JSON stringified) expression evaluated against nodes
-        :param sort_exp: Sorting expression evaluated against nodes
-        :param limit: Maximum number of nodes to return
-        :param offset: Pagination offset
-        :param filter_: Filter object (JSON stringified) to select nodes
+        :param filter_exp: Filter expression to evaluate against Nodes for inclusion in the response.
+        :param sort_exp: Sorting expression to evaluate against Nodes to specify the sort order for the response.
+        :param filter_: JSON-stringified filter object to evaluate against Nodes for inclusion in the response.
+        :param sort: JSON-stringified sorting object to evaluate against Nodes to specify the sort order for the response.
+        :param limit: Maximum number of Nodes to return in the response for this request. Use with <code>offset</code> to paginate the response into manageable batches.
+        :param offset: Starting point from which to retrieve results for this request. Use with <code>limit</code> to paginate the response into manageable batches.
         :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
@@ -167,11 +167,11 @@ class Nodes(BaseSDK):
 
         request = models.ListMasterWorkerEntryRequest(
             filter_exp=filter_exp,
-            sort=sort,
             sort_exp=sort_exp,
+            filter_=filter_,
+            sort=sort,
             limit=limit,
             offset=offset,
-            filter_=filter_,
         )
 
         req = self._build_request_async(
@@ -239,11 +239,11 @@ class Nodes(BaseSDK):
         timeout_ms: Optional[int] = None,
         http_headers: Optional[Mapping[str, str]] = None,
     ) -> models.GetMasterWorkerEntryResponse:
-        r"""Retrieve a count of Worker and Edge Nodes
+        r"""Get a count of Worker and Edge Nodes
 
-        get worker and edge nodes count
+        Get a count of all Worker and Edge Nodes.
 
-        :param filter_exp: Filter expression evaluated against nodes
+        :param filter_exp: Filter expression to evaluate against Nodes for inclusion in the response.
         :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
@@ -328,11 +328,11 @@ class Nodes(BaseSDK):
         timeout_ms: Optional[int] = None,
         http_headers: Optional[Mapping[str, str]] = None,
     ) -> models.GetMasterWorkerEntryResponse:
-        r"""Retrieve a count of Worker and Edge Nodes
+        r"""Get a count of Worker and Edge Nodes
 
-        get worker and edge nodes count
+        Get a count of all Worker and Edge Nodes.
 
-        :param filter_exp: Filter expression evaluated against nodes
+        :param filter_exp: Filter expression to evaluate against Nodes for inclusion in the response.
         :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

cribl_control_plane/packs.py

@@ -38,7 +38,7 @@ class Packs(BaseSDK):
     ) -> models.CreatePacksResponse:
         r"""Install a Pack
 
-        Install Pack
+        Install a Pack.
 
         :param id:
         :param source:
@@ -169,7 +169,7 @@ class Packs(BaseSDK):
     ) -> models.CreatePacksResponse:
         r"""Install a Pack
 
-        Install Pack
+        Install a Pack.
 
         :param id:
         :param source:
@@ -285,9 +285,9 @@ class Packs(BaseSDK):
     ) -> models.GetPacksResponse:
         r"""List all Packs
 
-        Get info on packs
+        Get a list of all Packs.
 
-        :param with_: Comma separated list of entities, \"outputs\", \"inputs\"
+        :param with_: Comma-separated list of additional properties to include in the response. When set, the response includes a count of the specified properties in the Pack. Available values are <code>inputs</code> and <code>outputs</code>.
         :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
@@ -372,9 +372,9 @@ class Packs(BaseSDK):
     ) -> models.GetPacksResponse:
         r"""List all Packs
 
-        Get info on packs
+        Get a list of all Packs.
 
-        :param with_: Comma separated list of entities, \"outputs\", \"inputs\"
+        :param with_: Comma-separated list of additional properties to include in the response. When set, the response includes a count of the specified properties in the Pack. Available values are <code>inputs</code> and <code>outputs</code>.
         :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
@@ -459,9 +459,9 @@ class Packs(BaseSDK):
     ) -> models.DeletePacksByIDResponse:
         r"""Uninstall a Pack
 
-        Uninstall Pack from the system
+        Uninstall the specified Pack.
 
-        :param id: Pack name
+        :param id: The <code>id</code> of the Pack to uninstall.
         :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
@@ -546,9 +546,9 @@ class Packs(BaseSDK):
     ) -> models.DeletePacksByIDResponse:
         r"""Uninstall a Pack
 
-        Uninstall Pack from the system
+        Uninstall the specified Pack.
 
-        :param id: Pack name
+        :param id: The <code>id</code> of the Pack to uninstall.
         :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
@@ -634,11 +634,11 @@ class Packs(BaseSDK):
         timeout_ms: Optional[int] = None,
         http_headers: Optional[Mapping[str, str]] = None,
     ) -> models.UpdatePacksByIDResponse:
-        r"""Update a Pack
+        r"""Upgrade a Pack
 
-        Upgrade Pack
+        Upgrade the specified Pack.</br></br>If the Pack includes any user–modified versions of default Cribl Knowledge resources such as lookups, copy the modified files locally for safekeeping before upgrading the Pack. Copy the modified files back to the upgraded Pack after you install it with <code>POST /packs</code> to overwrite the default versions in the Pack.</br></br>After you upgrade the Pack, update any Routes, Pipelines, Sources, and Destinations that use the previous Pack version so that they reference the upgraded Pack.
 
-        :param id: Pack name
+        :param id: The <code>id</code> of the Pack to upgrade.
         :param source: body string required Pack source
         :param minor: body boolean optional Only upgrade to minor/patch versions
         :param spec: body string optional Specify a branch, tag or a semver spec
@@ -730,11 +730,11 @@ class Packs(BaseSDK):
         timeout_ms: Optional[int] = None,
         http_headers: Optional[Mapping[str, str]] = None,
     ) -> models.UpdatePacksByIDResponse:
-        r"""Update a Pack
+        r"""Upgrade a Pack
 
-        Upgrade Pack
+        Upgrade the specified Pack.</br></br>If the Pack includes any user–modified versions of default Cribl Knowledge resources such as lookups, copy the modified files locally for safekeeping before upgrading the Pack. Copy the modified files back to the upgraded Pack after you install it with <code>POST /packs</code> to overwrite the default versions in the Pack.</br></br>After you upgrade the Pack, update any Routes, Pipelines, Sources, and Destinations that use the previous Pack version so that they reference the upgraded Pack.
 
-        :param id: Pack name
+        :param id: The <code>id</code> of the Pack to upgrade.
         :param source: body string required Pack source
         :param minor: body boolean optional Only upgrade to minor/patch versions
         :param spec: body string optional Specify a branch, tag or a semver spec

cribl_control_plane/samples.py

@@ -19,11 +19,11 @@ class Samples(BaseSDK):
         timeout_ms: Optional[int] = None,
         http_headers: Optional[Mapping[str, str]] = None,
     ) -> models.GetOutputSamplesByIDResponse:
-        r"""Retrieve sample event data for a Destination
+        r"""Get sample event data for a Destination
 
-        Retrieve samples data for the specified destination. Used to get sample data for the test action.
+        Get sample event data for the specified Destination to validate the configuration or test connectivity.
 
-        :param id: Destination Id
+        :param id: The <code>id</code> of the Destination to get sample event data for.
         :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
@@ -108,11 +108,11 @@ class Samples(BaseSDK):
         timeout_ms: Optional[int] = None,
         http_headers: Optional[Mapping[str, str]] = None,
     ) -> models.GetOutputSamplesByIDResponse:
-        r"""Retrieve sample event data for a Destination
+        r"""Get sample event data for a Destination
 
-        Retrieve samples data for the specified destination. Used to get sample data for the test action.
+        Get sample event data for the specified Destination to validate the configuration or test connectivity.
 
-        :param id: Destination Id
+        :param id: The <code>id</code> of the Destination to get sample event data for.
         :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
@@ -200,9 +200,9 @@ class Samples(BaseSDK):
     ) -> models.CreateOutputTestByIDResponse:
         r"""Send sample event data to a Destination
 
-        Send sample data to a destination to validate configuration or test connectivity
+        Send sample event data to the specified Destination to validate the configuration or test connectivity.
 
-        :param id: Destination Id
+        :param id: The <code>id</code> of the Destination to send sample event data to.
         :param events:
         :param retries: Override the default retry configuration for this method
         :param server_url: Override the default server URL for this method
@@ -301,9 +301,9 @@ class Samples(BaseSDK):
     ) -> models.CreateOutputTestByIDResponse:
         r"""Send sample event data to a Destination
 
-        Send sample data to a destination to validate configuration or test connectivity
+        Send sample event data to the specified Destination to validate the configuration or test connectivity.
 
-        :param id: Destination Id
+        :param id: The <code>id</code> of the Destination to send sample event data to.
         :param events:
         :param retries: Override the default retry configuration for this method
         :param server_url: Override the default server URL for this method