stackgen-sdk 0.1.1__py3-none-any.whl

stackgen/generated/api/sre_api.py

@@ -0,0 +1,1618 @@
+# coding: utf-8
+
+"""
+    StackGen External API
+
+    Allowlisted StackGen API surface for the public SDK. Managed via api-docs/product/allowlists/external.yaml.
+
+    The version of the OpenAPI document: 0.1.0
+    Generated by OpenAPI Generator (https://openapi-generator.tech)
+
+    Do not edit the class manually.
+"""  # noqa: E501
+
+import warnings
+from pydantic import validate_call, Field, StrictFloat, StrictStr, StrictInt
+from typing import Any, Dict, List, Optional, Tuple, Union
+from typing_extensions import Annotated
+
+from pydantic import Field, StrictStr
+from typing import List, Optional
+from typing_extensions import Annotated
+from stackgen.generated.models.alert_attention import AlertAttention
+from stackgen.generated.models.alert_role import AlertRole
+from stackgen.generated.models.alert_sort_by import AlertSortBy
+from stackgen.generated.models.alert_status import AlertStatus
+from stackgen.generated.models.alert_v1 import AlertV1
+from stackgen.generated.models.investigate_alert_request import InvestigateAlertRequest
+from stackgen.generated.models.investigate_response import InvestigateResponse
+from stackgen.generated.models.investigation import Investigation
+from stackgen.generated.models.investigation_status import InvestigationStatus
+from stackgen.generated.models.list_alerts_response import ListAlertsResponse
+from stackgen.generated.models.list_investigations_response import ListInvestigationsResponse
+from stackgen.generated.models.signal_severity import SignalSeverity
+
+from stackgen.generated.api_client import ApiClient, RequestSerialized
+from stackgen.generated.api_response import ApiResponse
+from stackgen.generated.rest import RESTResponseType
+
+
+class SREApi:
+    """NOTE: This class is auto generated by OpenAPI Generator
+    Ref: https://openapi-generator.tech
+
+    Do not edit the class manually.
+    """
+
+    def __init__(self, api_client=None) -> None:
+        if api_client is None:
+            api_client = ApiClient.get_default()
+        self.api_client = api_client
+
+
+    @validate_call
+    def get_alert_v1(
+        self,
+        id: Annotated[StrictStr, Field(description="Internal alert UUID or stable source external_uid.")],
+        _request_timeout: Union[
+            None,
+            Annotated[StrictFloat, Field(gt=0)],
+            Tuple[
+                Annotated[StrictFloat, Field(gt=0)],
+                Annotated[StrictFloat, Field(gt=0)]
+            ]
+        ] = None,
+        _request_auth: Optional[Dict[StrictStr, Any]] = None,
+        _content_type: Optional[StrictStr] = None,
+        _headers: Optional[Dict[StrictStr, Any]] = None,
+        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
+    ) -> AlertV1:
+        """Get a single alert by id (alert detail / per-alert read)
+
+        Returns one alert by internal UUID or by source external_uid (e.g. Grafana fingerprint). Use this for alert detail, per-alert reads, and recovering a full title when a list payload is truncated or compressed. Use external_uid for shareable deep links; pagination is not required. 
+
+        :param id: Internal alert UUID or stable source external_uid. (required)
+        :type id: str
+        :param _request_timeout: timeout setting for this request. If one
+                                 number provided, it will be total request
+                                 timeout. It can also be a pair (tuple) of
+                                 (connection, read) timeouts.
+        :type _request_timeout: int, tuple(int, int), optional
+        :param _request_auth: set to override the auth_settings for an a single
+                              request; this effectively ignores the
+                              authentication in the spec for a single request.
+        :type _request_auth: dict, optional
+        :param _content_type: force content-type for the request.
+        :type _content_type: str, Optional
+        :param _headers: set to override the headers for a single
+                         request; this effectively ignores the headers
+                         in the spec for a single request.
+        :type _headers: dict, optional
+        :param _host_index: set to override the host_index for a single
+                            request; this effectively ignores the host_index
+                            in the spec for a single request.
+        :type _host_index: int, optional
+        :return: Returns the result object.
+        """ # noqa: E501
+
+        _param = self._get_alert_v1_serialize(
+            id=id,
+            _request_auth=_request_auth,
+            _content_type=_content_type,
+            _headers=_headers,
+            _host_index=_host_index
+        )
+
+        _response_types_map: Dict[str, Optional[str]] = {
+            '200': "AlertV1",
+            '404': "ErrorResponse",
+        }
+        response_data = self.api_client.call_api(
+            *_param,
+            _request_timeout=_request_timeout
+        )
+        response_data.read()
+        return self.api_client.response_deserialize(
+            response_data=response_data,
+            response_types_map=_response_types_map,
+        ).data
+
+
+    @validate_call
+    def get_alert_v1_with_http_info(
+        self,
+        id: Annotated[StrictStr, Field(description="Internal alert UUID or stable source external_uid.")],
+        _request_timeout: Union[
+            None,
+            Annotated[StrictFloat, Field(gt=0)],
+            Tuple[
+                Annotated[StrictFloat, Field(gt=0)],
+                Annotated[StrictFloat, Field(gt=0)]
+            ]
+        ] = None,
+        _request_auth: Optional[Dict[StrictStr, Any]] = None,
+        _content_type: Optional[StrictStr] = None,
+        _headers: Optional[Dict[StrictStr, Any]] = None,
+        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
+    ) -> ApiResponse[AlertV1]:
+        """Get a single alert by id (alert detail / per-alert read)
+
+        Returns one alert by internal UUID or by source external_uid (e.g. Grafana fingerprint). Use this for alert detail, per-alert reads, and recovering a full title when a list payload is truncated or compressed. Use external_uid for shareable deep links; pagination is not required. 
+
+        :param id: Internal alert UUID or stable source external_uid. (required)
+        :type id: str
+        :param _request_timeout: timeout setting for this request. If one
+                                 number provided, it will be total request
+                                 timeout. It can also be a pair (tuple) of
+                                 (connection, read) timeouts.
+        :type _request_timeout: int, tuple(int, int), optional
+        :param _request_auth: set to override the auth_settings for an a single
+                              request; this effectively ignores the
+                              authentication in the spec for a single request.
+        :type _request_auth: dict, optional
+        :param _content_type: force content-type for the request.
+        :type _content_type: str, Optional
+        :param _headers: set to override the headers for a single
+                         request; this effectively ignores the headers
+                         in the spec for a single request.
+        :type _headers: dict, optional
+        :param _host_index: set to override the host_index for a single
+                            request; this effectively ignores the host_index
+                            in the spec for a single request.
+        :type _host_index: int, optional
+        :return: Returns the result object.
+        """ # noqa: E501
+
+        _param = self._get_alert_v1_serialize(
+            id=id,
+            _request_auth=_request_auth,
+            _content_type=_content_type,
+            _headers=_headers,
+            _host_index=_host_index
+        )
+
+        _response_types_map: Dict[str, Optional[str]] = {
+            '200': "AlertV1",
+            '404': "ErrorResponse",
+        }
+        response_data = self.api_client.call_api(
+            *_param,
+            _request_timeout=_request_timeout
+        )
+        response_data.read()
+        return self.api_client.response_deserialize(
+            response_data=response_data,
+            response_types_map=_response_types_map,
+        )
+
+
+    @validate_call
+    def get_alert_v1_without_preload_content(
+        self,
+        id: Annotated[StrictStr, Field(description="Internal alert UUID or stable source external_uid.")],
+        _request_timeout: Union[
+            None,
+            Annotated[StrictFloat, Field(gt=0)],
+            Tuple[
+                Annotated[StrictFloat, Field(gt=0)],
+                Annotated[StrictFloat, Field(gt=0)]
+            ]
+        ] = None,
+        _request_auth: Optional[Dict[StrictStr, Any]] = None,
+        _content_type: Optional[StrictStr] = None,
+        _headers: Optional[Dict[StrictStr, Any]] = None,
+        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
+    ) -> RESTResponseType:
+        """Get a single alert by id (alert detail / per-alert read)
+
+        Returns one alert by internal UUID or by source external_uid (e.g. Grafana fingerprint). Use this for alert detail, per-alert reads, and recovering a full title when a list payload is truncated or compressed. Use external_uid for shareable deep links; pagination is not required. 
+
+        :param id: Internal alert UUID or stable source external_uid. (required)
+        :type id: str
+        :param _request_timeout: timeout setting for this request. If one
+                                 number provided, it will be total request
+                                 timeout. It can also be a pair (tuple) of
+                                 (connection, read) timeouts.
+        :type _request_timeout: int, tuple(int, int), optional
+        :param _request_auth: set to override the auth_settings for an a single
+                              request; this effectively ignores the
+                              authentication in the spec for a single request.
+        :type _request_auth: dict, optional
+        :param _content_type: force content-type for the request.
+        :type _content_type: str, Optional
+        :param _headers: set to override the headers for a single
+                         request; this effectively ignores the headers
+                         in the spec for a single request.
+        :type _headers: dict, optional
+        :param _host_index: set to override the host_index for a single
+                            request; this effectively ignores the host_index
+                            in the spec for a single request.
+        :type _host_index: int, optional
+        :return: Returns the result object.
+        """ # noqa: E501
+
+        _param = self._get_alert_v1_serialize(
+            id=id,
+            _request_auth=_request_auth,
+            _content_type=_content_type,
+            _headers=_headers,
+            _host_index=_host_index
+        )
+
+        _response_types_map: Dict[str, Optional[str]] = {
+            '200': "AlertV1",
+            '404': "ErrorResponse",
+        }
+        response_data = self.api_client.call_api(
+            *_param,
+            _request_timeout=_request_timeout
+        )
+        return response_data.response
+
+
+    def _get_alert_v1_serialize(
+        self,
+        id,
+        _request_auth,
+        _content_type,
+        _headers,
+        _host_index,
+    ) -> RequestSerialized:
+
+        _host = None
+
+        _collection_formats: Dict[str, str] = {
+        }
+
+        _path_params: Dict[str, str] = {}
+        _query_params: List[Tuple[str, str]] = []
+        _header_params: Dict[str, Optional[str]] = _headers or {}
+        _form_params: List[Tuple[str, str]] = []
+        _files: Dict[
+            str, Union[str, bytes, List[str], List[bytes], List[Tuple[str, bytes]]]
+        ] = {}
+        _body_params: Optional[bytes] = None
+
+        # process the path parameters
+        if id is not None:
+            _path_params['id'] = id
+        # process the query parameters
+        # process the header parameters
+        # process the form parameters
+        # process the body parameter
+
+
+        # set the HTTP header `Accept`
+        if 'Accept' not in _header_params:
+            _header_params['Accept'] = self.api_client.select_header_accept(
+                [
+                    'application/json'
+                ]
+            )
+
+
+        # authentication setting
+        _auth_settings: List[str] = [
+            'ApiToken'
+        ]
+
+        return self.api_client.param_serialize(
+            method='GET',
+            resource_path='/app/sre/api/v1/alerts/{id}',
+            path_params=_path_params,
+            query_params=_query_params,
+            header_params=_header_params,
+            body=_body_params,
+            post_params=_form_params,
+            files=_files,
+            auth_settings=_auth_settings,
+            collection_formats=_collection_formats,
+            _host=_host,
+            _request_auth=_request_auth
+        )
+
+
+
+
+    @validate_call
+    def get_investigation(
+        self,
+        id: StrictStr,
+        _request_timeout: Union[
+            None,
+            Annotated[StrictFloat, Field(gt=0)],
+            Tuple[
+                Annotated[StrictFloat, Field(gt=0)],
+                Annotated[StrictFloat, Field(gt=0)]
+            ]
+        ] = None,
+        _request_auth: Optional[Dict[StrictStr, Any]] = None,
+        _content_type: Optional[StrictStr] = None,
+        _headers: Optional[Dict[StrictStr, Any]] = None,
+        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
+    ) -> Investigation:
+        """Get investigation details, evidence, and RCA by ID
+
+        Returns the complete caller-scoped investigation identified by its UUID, including lifecycle state, result summary, evidence, and RCA fields when available. Use this operation for investigation details or status when the investigation ID is already known; use listInvestigations first when the ID is unknown. 
+
+        :param id: (required)
+        :type id: str
+        :param _request_timeout: timeout setting for this request. If one
+                                 number provided, it will be total request
+                                 timeout. It can also be a pair (tuple) of
+                                 (connection, read) timeouts.
+        :type _request_timeout: int, tuple(int, int), optional
+        :param _request_auth: set to override the auth_settings for an a single
+                              request; this effectively ignores the
+                              authentication in the spec for a single request.
+        :type _request_auth: dict, optional
+        :param _content_type: force content-type for the request.
+        :type _content_type: str, Optional
+        :param _headers: set to override the headers for a single
+                         request; this effectively ignores the headers
+                         in the spec for a single request.
+        :type _headers: dict, optional
+        :param _host_index: set to override the host_index for a single
+                            request; this effectively ignores the host_index
+                            in the spec for a single request.
+        :type _host_index: int, optional
+        :return: Returns the result object.
+        """ # noqa: E501
+
+        _param = self._get_investigation_serialize(
+            id=id,
+            _request_auth=_request_auth,
+            _content_type=_content_type,
+            _headers=_headers,
+            _host_index=_host_index
+        )
+
+        _response_types_map: Dict[str, Optional[str]] = {
+            '200': "Investigation",
+            '404': "ErrorResponse",
+        }
+        response_data = self.api_client.call_api(
+            *_param,
+            _request_timeout=_request_timeout
+        )
+        response_data.read()
+        return self.api_client.response_deserialize(
+            response_data=response_data,
+            response_types_map=_response_types_map,
+        ).data
+
+
+    @validate_call
+    def get_investigation_with_http_info(
+        self,
+        id: StrictStr,
+        _request_timeout: Union[
+            None,
+            Annotated[StrictFloat, Field(gt=0)],
+            Tuple[
+                Annotated[StrictFloat, Field(gt=0)],
+                Annotated[StrictFloat, Field(gt=0)]
+            ]
+        ] = None,
+        _request_auth: Optional[Dict[StrictStr, Any]] = None,
+        _content_type: Optional[StrictStr] = None,
+        _headers: Optional[Dict[StrictStr, Any]] = None,
+        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
+    ) -> ApiResponse[Investigation]:
+        """Get investigation details, evidence, and RCA by ID
+
+        Returns the complete caller-scoped investigation identified by its UUID, including lifecycle state, result summary, evidence, and RCA fields when available. Use this operation for investigation details or status when the investigation ID is already known; use listInvestigations first when the ID is unknown. 
+
+        :param id: (required)
+        :type id: str
+        :param _request_timeout: timeout setting for this request. If one
+                                 number provided, it will be total request
+                                 timeout. It can also be a pair (tuple) of
+                                 (connection, read) timeouts.
+        :type _request_timeout: int, tuple(int, int), optional
+        :param _request_auth: set to override the auth_settings for an a single
+                              request; this effectively ignores the
+                              authentication in the spec for a single request.
+        :type _request_auth: dict, optional
+        :param _content_type: force content-type for the request.
+        :type _content_type: str, Optional
+        :param _headers: set to override the headers for a single
+                         request; this effectively ignores the headers
+                         in the spec for a single request.
+        :type _headers: dict, optional
+        :param _host_index: set to override the host_index for a single
+                            request; this effectively ignores the host_index
+                            in the spec for a single request.
+        :type _host_index: int, optional
+        :return: Returns the result object.
+        """ # noqa: E501
+
+        _param = self._get_investigation_serialize(
+            id=id,
+            _request_auth=_request_auth,
+            _content_type=_content_type,
+            _headers=_headers,
+            _host_index=_host_index
+        )
+
+        _response_types_map: Dict[str, Optional[str]] = {
+            '200': "Investigation",
+            '404': "ErrorResponse",
+        }
+        response_data = self.api_client.call_api(
+            *_param,
+            _request_timeout=_request_timeout
+        )
+        response_data.read()
+        return self.api_client.response_deserialize(
+            response_data=response_data,
+            response_types_map=_response_types_map,
+        )
+
+
+    @validate_call
+    def get_investigation_without_preload_content(
+        self,
+        id: StrictStr,
+        _request_timeout: Union[
+            None,
+            Annotated[StrictFloat, Field(gt=0)],
+            Tuple[
+                Annotated[StrictFloat, Field(gt=0)],
+                Annotated[StrictFloat, Field(gt=0)]
+            ]
+        ] = None,
+        _request_auth: Optional[Dict[StrictStr, Any]] = None,
+        _content_type: Optional[StrictStr] = None,
+        _headers: Optional[Dict[StrictStr, Any]] = None,
+        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
+    ) -> RESTResponseType:
+        """Get investigation details, evidence, and RCA by ID
+
+        Returns the complete caller-scoped investigation identified by its UUID, including lifecycle state, result summary, evidence, and RCA fields when available. Use this operation for investigation details or status when the investigation ID is already known; use listInvestigations first when the ID is unknown. 
+
+        :param id: (required)
+        :type id: str
+        :param _request_timeout: timeout setting for this request. If one
+                                 number provided, it will be total request
+                                 timeout. It can also be a pair (tuple) of
+                                 (connection, read) timeouts.
+        :type _request_timeout: int, tuple(int, int), optional
+        :param _request_auth: set to override the auth_settings for an a single
+                              request; this effectively ignores the
+                              authentication in the spec for a single request.
+        :type _request_auth: dict, optional
+        :param _content_type: force content-type for the request.
+        :type _content_type: str, Optional
+        :param _headers: set to override the headers for a single
+                         request; this effectively ignores the headers
+                         in the spec for a single request.
+        :type _headers: dict, optional
+        :param _host_index: set to override the host_index for a single
+                            request; this effectively ignores the host_index
+                            in the spec for a single request.
+        :type _host_index: int, optional
+        :return: Returns the result object.
+        """ # noqa: E501
+
+        _param = self._get_investigation_serialize(
+            id=id,
+            _request_auth=_request_auth,
+            _content_type=_content_type,
+            _headers=_headers,
+            _host_index=_host_index
+        )
+
+        _response_types_map: Dict[str, Optional[str]] = {
+            '200': "Investigation",
+            '404': "ErrorResponse",
+        }
+        response_data = self.api_client.call_api(
+            *_param,
+            _request_timeout=_request_timeout
+        )
+        return response_data.response
+
+
+    def _get_investigation_serialize(
+        self,
+        id,
+        _request_auth,
+        _content_type,
+        _headers,
+        _host_index,
+    ) -> RequestSerialized:
+
+        _host = None
+
+        _collection_formats: Dict[str, str] = {
+        }
+
+        _path_params: Dict[str, str] = {}
+        _query_params: List[Tuple[str, str]] = []
+        _header_params: Dict[str, Optional[str]] = _headers or {}
+        _form_params: List[Tuple[str, str]] = []
+        _files: Dict[
+            str, Union[str, bytes, List[str], List[bytes], List[Tuple[str, bytes]]]
+        ] = {}
+        _body_params: Optional[bytes] = None
+
+        # process the path parameters
+        if id is not None:
+            _path_params['id'] = id
+        # process the query parameters
+        # process the header parameters
+        # process the form parameters
+        # process the body parameter
+
+
+        # set the HTTP header `Accept`
+        if 'Accept' not in _header_params:
+            _header_params['Accept'] = self.api_client.select_header_accept(
+                [
+                    'application/json'
+                ]
+            )
+
+
+        # authentication setting
+        _auth_settings: List[str] = [
+            'ApiToken'
+        ]
+
+        return self.api_client.param_serialize(
+            method='GET',
+            resource_path='/app/sre/api/v1/investigations/{id}',
+            path_params=_path_params,
+            query_params=_query_params,
+            header_params=_header_params,
+            body=_body_params,
+            post_params=_form_params,
+            files=_files,
+            auth_settings=_auth_settings,
+            collection_formats=_collection_formats,
+            _host=_host,
+            _request_auth=_request_auth
+        )
+
+
+
+
+    @validate_call
+    def investigate_alert(
+        self,
+        id: StrictStr,
+        investigate_alert_request: Optional[InvestigateAlertRequest] = None,
+        _request_timeout: Union[
+            None,
+            Annotated[StrictFloat, Field(gt=0)],
+            Tuple[
+                Annotated[StrictFloat, Field(gt=0)],
+                Annotated[StrictFloat, Field(gt=0)]
+            ]
+        ] = None,
+        _request_auth: Optional[Dict[StrictStr, Any]] = None,
+        _content_type: Optional[StrictStr] = None,
+        _headers: Optional[Dict[StrictStr, Any]] = None,
+        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
+    ) -> InvestigateResponse:
+        """Start or retrieve a deep-dive investigation
+
+        If no investigation exists for this alert, creates an investigations row and launches a Aiden workflow. If one already exists (any status), returns it unchanged. 
+
+        :param id: (required)
+        :type id: str
+        :param investigate_alert_request:
+        :type investigate_alert_request: InvestigateAlertRequest
+        :param _request_timeout: timeout setting for this request. If one
+                                 number provided, it will be total request
+                                 timeout. It can also be a pair (tuple) of
+                                 (connection, read) timeouts.
+        :type _request_timeout: int, tuple(int, int), optional
+        :param _request_auth: set to override the auth_settings for an a single
+                              request; this effectively ignores the
+                              authentication in the spec for a single request.
+        :type _request_auth: dict, optional
+        :param _content_type: force content-type for the request.
+        :type _content_type: str, Optional
+        :param _headers: set to override the headers for a single
+                         request; this effectively ignores the headers
+                         in the spec for a single request.
+        :type _headers: dict, optional
+        :param _host_index: set to override the host_index for a single
+                            request; this effectively ignores the host_index
+                            in the spec for a single request.
+        :type _host_index: int, optional
+        :return: Returns the result object.
+        """ # noqa: E501
+
+        _param = self._investigate_alert_serialize(
+            id=id,
+            investigate_alert_request=investigate_alert_request,
+            _request_auth=_request_auth,
+            _content_type=_content_type,
+            _headers=_headers,
+            _host_index=_host_index
+        )
+
+        _response_types_map: Dict[str, Optional[str]] = {
+            '200': "InvestigateResponse",
+            '404': "ErrorResponse",
+        }
+        response_data = self.api_client.call_api(
+            *_param,
+            _request_timeout=_request_timeout
+        )
+        response_data.read()
+        return self.api_client.response_deserialize(
+            response_data=response_data,
+            response_types_map=_response_types_map,
+        ).data
+
+
+    @validate_call
+    def investigate_alert_with_http_info(
+        self,
+        id: StrictStr,
+        investigate_alert_request: Optional[InvestigateAlertRequest] = None,
+        _request_timeout: Union[
+            None,
+            Annotated[StrictFloat, Field(gt=0)],
+            Tuple[
+                Annotated[StrictFloat, Field(gt=0)],
+                Annotated[StrictFloat, Field(gt=0)]
+            ]
+        ] = None,
+        _request_auth: Optional[Dict[StrictStr, Any]] = None,
+        _content_type: Optional[StrictStr] = None,
+        _headers: Optional[Dict[StrictStr, Any]] = None,
+        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
+    ) -> ApiResponse[InvestigateResponse]:
+        """Start or retrieve a deep-dive investigation
+
+        If no investigation exists for this alert, creates an investigations row and launches a Aiden workflow. If one already exists (any status), returns it unchanged. 
+
+        :param id: (required)
+        :type id: str
+        :param investigate_alert_request:
+        :type investigate_alert_request: InvestigateAlertRequest
+        :param _request_timeout: timeout setting for this request. If one
+                                 number provided, it will be total request
+                                 timeout. It can also be a pair (tuple) of
+                                 (connection, read) timeouts.
+        :type _request_timeout: int, tuple(int, int), optional
+        :param _request_auth: set to override the auth_settings for an a single
+                              request; this effectively ignores the
+                              authentication in the spec for a single request.
+        :type _request_auth: dict, optional
+        :param _content_type: force content-type for the request.
+        :type _content_type: str, Optional
+        :param _headers: set to override the headers for a single
+                         request; this effectively ignores the headers
+                         in the spec for a single request.
+        :type _headers: dict, optional
+        :param _host_index: set to override the host_index for a single
+                            request; this effectively ignores the host_index
+                            in the spec for a single request.
+        :type _host_index: int, optional
+        :return: Returns the result object.
+        """ # noqa: E501
+
+        _param = self._investigate_alert_serialize(
+            id=id,
+            investigate_alert_request=investigate_alert_request,
+            _request_auth=_request_auth,
+            _content_type=_content_type,
+            _headers=_headers,
+            _host_index=_host_index
+        )
+
+        _response_types_map: Dict[str, Optional[str]] = {
+            '200': "InvestigateResponse",
+            '404': "ErrorResponse",
+        }
+        response_data = self.api_client.call_api(
+            *_param,
+            _request_timeout=_request_timeout
+        )
+        response_data.read()
+        return self.api_client.response_deserialize(
+            response_data=response_data,
+            response_types_map=_response_types_map,
+        )
+
+
+    @validate_call
+    def investigate_alert_without_preload_content(
+        self,
+        id: StrictStr,
+        investigate_alert_request: Optional[InvestigateAlertRequest] = None,
+        _request_timeout: Union[
+            None,
+            Annotated[StrictFloat, Field(gt=0)],
+            Tuple[
+                Annotated[StrictFloat, Field(gt=0)],
+                Annotated[StrictFloat, Field(gt=0)]
+            ]
+        ] = None,
+        _request_auth: Optional[Dict[StrictStr, Any]] = None,
+        _content_type: Optional[StrictStr] = None,
+        _headers: Optional[Dict[StrictStr, Any]] = None,
+        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
+    ) -> RESTResponseType:
+        """Start or retrieve a deep-dive investigation
+
+        If no investigation exists for this alert, creates an investigations row and launches a Aiden workflow. If one already exists (any status), returns it unchanged. 
+
+        :param id: (required)
+        :type id: str
+        :param investigate_alert_request:
+        :type investigate_alert_request: InvestigateAlertRequest
+        :param _request_timeout: timeout setting for this request. If one
+                                 number provided, it will be total request
+                                 timeout. It can also be a pair (tuple) of
+                                 (connection, read) timeouts.
+        :type _request_timeout: int, tuple(int, int), optional
+        :param _request_auth: set to override the auth_settings for an a single
+                              request; this effectively ignores the
+                              authentication in the spec for a single request.
+        :type _request_auth: dict, optional
+        :param _content_type: force content-type for the request.
+        :type _content_type: str, Optional
+        :param _headers: set to override the headers for a single
+                         request; this effectively ignores the headers
+                         in the spec for a single request.
+        :type _headers: dict, optional
+        :param _host_index: set to override the host_index for a single
+                            request; this effectively ignores the host_index
+                            in the spec for a single request.
+        :type _host_index: int, optional
+        :return: Returns the result object.
+        """ # noqa: E501
+
+        _param = self._investigate_alert_serialize(
+            id=id,
+            investigate_alert_request=investigate_alert_request,
+            _request_auth=_request_auth,
+            _content_type=_content_type,
+            _headers=_headers,
+            _host_index=_host_index
+        )
+
+        _response_types_map: Dict[str, Optional[str]] = {
+            '200': "InvestigateResponse",
+            '404': "ErrorResponse",
+        }
+        response_data = self.api_client.call_api(
+            *_param,
+            _request_timeout=_request_timeout
+        )
+        return response_data.response
+
+
+    def _investigate_alert_serialize(
+        self,
+        id,
+        investigate_alert_request,
+        _request_auth,
+        _content_type,
+        _headers,
+        _host_index,
+    ) -> RequestSerialized:
+
+        _host = None
+
+        _collection_formats: Dict[str, str] = {
+        }
+
+        _path_params: Dict[str, str] = {}
+        _query_params: List[Tuple[str, str]] = []
+        _header_params: Dict[str, Optional[str]] = _headers or {}
+        _form_params: List[Tuple[str, str]] = []
+        _files: Dict[
+            str, Union[str, bytes, List[str], List[bytes], List[Tuple[str, bytes]]]
+        ] = {}
+        _body_params: Optional[bytes] = None
+
+        # process the path parameters
+        if id is not None:
+            _path_params['id'] = id
+        # process the query parameters
+        # process the header parameters
+        # process the form parameters
+        # process the body parameter
+        if investigate_alert_request is not None:
+            _body_params = investigate_alert_request
+
+
+        # set the HTTP header `Accept`
+        if 'Accept' not in _header_params:
+            _header_params['Accept'] = self.api_client.select_header_accept(
+                [
+                    'application/json'
+                ]
+            )
+
+        # set the HTTP header `Content-Type`
+        if _content_type:
+            _header_params['Content-Type'] = _content_type
+        else:
+            _default_content_type = (
+                self.api_client.select_header_content_type(
+                    [
+                        'application/json'
+                    ]
+                )
+            )
+            if _default_content_type is not None:
+                _header_params['Content-Type'] = _default_content_type
+
+        # authentication setting
+        _auth_settings: List[str] = [
+            'ApiToken'
+        ]
+
+        return self.api_client.param_serialize(
+            method='POST',
+            resource_path='/app/sre/api/v1/alerts/{id}/investigate',
+            path_params=_path_params,
+            query_params=_query_params,
+            header_params=_header_params,
+            body=_body_params,
+            post_params=_form_params,
+            files=_files,
+            auth_settings=_auth_settings,
+            collection_formats=_collection_formats,
+            _host=_host,
+            _request_auth=_request_auth
+        )
+
+
+
+
+    @validate_call
+    def list_alerts(
+        self,
+        status: Annotated[Optional[AlertStatus], Field(description="Filter by alert lifecycle status. Defaults to \"active\".")] = None,
+        attention: Annotated[Optional[AlertAttention], Field(description="Optional filter by triage attention category.")] = None,
+        source_type: Annotated[Optional[StrictStr], Field(description="Optional filter by alert source (e.g. \"grafana\").")] = None,
+        integration_names: Annotated[Optional[List[Annotated[str, Field(min_length=1, strict=True)]]], Field(description="Optional filter by one or more integration instance names (e.g. prod-grafana, sandbox-observenow). Summary counts and the alert list are scoped to these integrations when provided. ")] = None,
+        storm_id: Annotated[Optional[StrictStr], Field(description="Optional filter by correlated incident storm UUID. Returns all active alerts in the same ingest storm (for linked-alert navigation). ")] = None,
+        q: Annotated[Optional[StrictStr], Field(description="Optional case-insensitive search across alert titles and descriptions.")] = None,
+        signal_severity: Annotated[Optional[SignalSeverity], Field(description="Optional filter by normalized monitor signal severity (Critical, High, Medium, Low, info). Matches raw upstream source_severity values in each bucket before pagination. ")] = None,
+        alert_role: Annotated[Optional[AlertRole], Field(description="Optional filter by correlated alert role (root signal vs downstream effect). ")] = None,
+        sort_by: Annotated[Optional[AlertSortBy], Field(description="List ordering. `severity` (default) ranks by monitor display_priority. `impact` ranks by persisted blast-radius impact (env, scope, storm fanout) before severity as a tie-break. ")] = None,
+        page: Optional[Annotated[int, Field(strict=True, ge=1)]] = None,
+        page_size: Optional[Annotated[int, Field(le=500, strict=True, ge=1)]] = None,
+        _request_timeout: Union[
+            None,
+            Annotated[StrictFloat, Field(gt=0)],
+            Tuple[
+                Annotated[StrictFloat, Field(gt=0)],
+                Annotated[StrictFloat, Field(gt=0)]
+            ]
+        ] = None,
+        _request_auth: Optional[Dict[StrictStr, Any]] = None,
+        _content_type: Optional[StrictStr] = None,
+        _headers: Optional[Dict[StrictStr, Any]] = None,
+        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
+    ) -> ListAlertsResponse:
+        """List or count alerts with filters and summary totals
+
+        Returns a paginated alert inventory plus summary totals. Use this operation for \"list alerts\", \"count alerts\", firing-alert inventory, queue filtering, and alert searches. Read the response summary for counts instead of counting the current page. The summary is always for status=active; use `status` to switch the returned list between the Active tab (default) and Ignored tab. When listing titles and the tool result is truncated or compressed, read visible `id` values and call GET /api/v1/alerts/{id} (getAlertV1) per alert — do not invent titles. 
+
+        :param status: Filter by alert lifecycle status. Defaults to \"active\".
+        :type status: AlertStatus
+        :param attention: Optional filter by triage attention category.
+        :type attention: AlertAttention
+        :param source_type: Optional filter by alert source (e.g. \"grafana\").
+        :type source_type: str
+        :param integration_names: Optional filter by one or more integration instance names (e.g. prod-grafana, sandbox-observenow). Summary counts and the alert list are scoped to these integrations when provided. 
+        :type integration_names: List[str]
+        :param storm_id: Optional filter by correlated incident storm UUID. Returns all active alerts in the same ingest storm (for linked-alert navigation). 
+        :type storm_id: str
+        :param q: Optional case-insensitive search across alert titles and descriptions.
+        :type q: str
+        :param signal_severity: Optional filter by normalized monitor signal severity (Critical, High, Medium, Low, info). Matches raw upstream source_severity values in each bucket before pagination. 
+        :type signal_severity: SignalSeverity
+        :param alert_role: Optional filter by correlated alert role (root signal vs downstream effect). 
+        :type alert_role: AlertRole
+        :param sort_by: List ordering. `severity` (default) ranks by monitor display_priority. `impact` ranks by persisted blast-radius impact (env, scope, storm fanout) before severity as a tie-break. 
+        :type sort_by: AlertSortBy
+        :param page:
+        :type page: int
+        :param page_size:
+        :type page_size: int
+        :param _request_timeout: timeout setting for this request. If one
+                                 number provided, it will be total request
+                                 timeout. It can also be a pair (tuple) of
+                                 (connection, read) timeouts.
+        :type _request_timeout: int, tuple(int, int), optional
+        :param _request_auth: set to override the auth_settings for an a single
+                              request; this effectively ignores the
+                              authentication in the spec for a single request.
+        :type _request_auth: dict, optional
+        :param _content_type: force content-type for the request.
+        :type _content_type: str, Optional
+        :param _headers: set to override the headers for a single
+                         request; this effectively ignores the headers
+                         in the spec for a single request.
+        :type _headers: dict, optional
+        :param _host_index: set to override the host_index for a single
+                            request; this effectively ignores the host_index
+                            in the spec for a single request.
+        :type _host_index: int, optional
+        :return: Returns the result object.
+        """ # noqa: E501
+
+        _param = self._list_alerts_serialize(
+            status=status,
+            attention=attention,
+            source_type=source_type,
+            integration_names=integration_names,
+            storm_id=storm_id,
+            q=q,
+            signal_severity=signal_severity,
+            alert_role=alert_role,
+            sort_by=sort_by,
+            page=page,
+            page_size=page_size,
+            _request_auth=_request_auth,
+            _content_type=_content_type,
+            _headers=_headers,
+            _host_index=_host_index
+        )
+
+        _response_types_map: Dict[str, Optional[str]] = {
+            '200': "ListAlertsResponse",
+        }
+        response_data = self.api_client.call_api(
+            *_param,
+            _request_timeout=_request_timeout
+        )
+        response_data.read()
+        return self.api_client.response_deserialize(
+            response_data=response_data,
+            response_types_map=_response_types_map,
+        ).data
+
+
+    @validate_call
+    def list_alerts_with_http_info(
+        self,
+        status: Annotated[Optional[AlertStatus], Field(description="Filter by alert lifecycle status. Defaults to \"active\".")] = None,
+        attention: Annotated[Optional[AlertAttention], Field(description="Optional filter by triage attention category.")] = None,
+        source_type: Annotated[Optional[StrictStr], Field(description="Optional filter by alert source (e.g. \"grafana\").")] = None,
+        integration_names: Annotated[Optional[List[Annotated[str, Field(min_length=1, strict=True)]]], Field(description="Optional filter by one or more integration instance names (e.g. prod-grafana, sandbox-observenow). Summary counts and the alert list are scoped to these integrations when provided. ")] = None,
+        storm_id: Annotated[Optional[StrictStr], Field(description="Optional filter by correlated incident storm UUID. Returns all active alerts in the same ingest storm (for linked-alert navigation). ")] = None,
+        q: Annotated[Optional[StrictStr], Field(description="Optional case-insensitive search across alert titles and descriptions.")] = None,
+        signal_severity: Annotated[Optional[SignalSeverity], Field(description="Optional filter by normalized monitor signal severity (Critical, High, Medium, Low, info). Matches raw upstream source_severity values in each bucket before pagination. ")] = None,
+        alert_role: Annotated[Optional[AlertRole], Field(description="Optional filter by correlated alert role (root signal vs downstream effect). ")] = None,
+        sort_by: Annotated[Optional[AlertSortBy], Field(description="List ordering. `severity` (default) ranks by monitor display_priority. `impact` ranks by persisted blast-radius impact (env, scope, storm fanout) before severity as a tie-break. ")] = None,
+        page: Optional[Annotated[int, Field(strict=True, ge=1)]] = None,
+        page_size: Optional[Annotated[int, Field(le=500, strict=True, ge=1)]] = None,
+        _request_timeout: Union[
+            None,
+            Annotated[StrictFloat, Field(gt=0)],
+            Tuple[
+                Annotated[StrictFloat, Field(gt=0)],
+                Annotated[StrictFloat, Field(gt=0)]
+            ]
+        ] = None,
+        _request_auth: Optional[Dict[StrictStr, Any]] = None,
+        _content_type: Optional[StrictStr] = None,
+        _headers: Optional[Dict[StrictStr, Any]] = None,
+        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
+    ) -> ApiResponse[ListAlertsResponse]:
+        """List or count alerts with filters and summary totals
+
+        Returns a paginated alert inventory plus summary totals. Use this operation for \"list alerts\", \"count alerts\", firing-alert inventory, queue filtering, and alert searches. Read the response summary for counts instead of counting the current page. The summary is always for status=active; use `status` to switch the returned list between the Active tab (default) and Ignored tab. When listing titles and the tool result is truncated or compressed, read visible `id` values and call GET /api/v1/alerts/{id} (getAlertV1) per alert — do not invent titles. 
+
+        :param status: Filter by alert lifecycle status. Defaults to \"active\".
+        :type status: AlertStatus
+        :param attention: Optional filter by triage attention category.
+        :type attention: AlertAttention
+        :param source_type: Optional filter by alert source (e.g. \"grafana\").
+        :type source_type: str
+        :param integration_names: Optional filter by one or more integration instance names (e.g. prod-grafana, sandbox-observenow). Summary counts and the alert list are scoped to these integrations when provided. 
+        :type integration_names: List[str]
+        :param storm_id: Optional filter by correlated incident storm UUID. Returns all active alerts in the same ingest storm (for linked-alert navigation). 
+        :type storm_id: str
+        :param q: Optional case-insensitive search across alert titles and descriptions.
+        :type q: str
+        :param signal_severity: Optional filter by normalized monitor signal severity (Critical, High, Medium, Low, info). Matches raw upstream source_severity values in each bucket before pagination. 
+        :type signal_severity: SignalSeverity
+        :param alert_role: Optional filter by correlated alert role (root signal vs downstream effect). 
+        :type alert_role: AlertRole
+        :param sort_by: List ordering. `severity` (default) ranks by monitor display_priority. `impact` ranks by persisted blast-radius impact (env, scope, storm fanout) before severity as a tie-break. 
+        :type sort_by: AlertSortBy
+        :param page:
+        :type page: int
+        :param page_size:
+        :type page_size: int
+        :param _request_timeout: timeout setting for this request. If one
+                                 number provided, it will be total request
+                                 timeout. It can also be a pair (tuple) of
+                                 (connection, read) timeouts.
+        :type _request_timeout: int, tuple(int, int), optional
+        :param _request_auth: set to override the auth_settings for an a single
+                              request; this effectively ignores the
+                              authentication in the spec for a single request.
+        :type _request_auth: dict, optional
+        :param _content_type: force content-type for the request.
+        :type _content_type: str, Optional
+        :param _headers: set to override the headers for a single
+                         request; this effectively ignores the headers
+                         in the spec for a single request.
+        :type _headers: dict, optional
+        :param _host_index: set to override the host_index for a single
+                            request; this effectively ignores the host_index
+                            in the spec for a single request.
+        :type _host_index: int, optional
+        :return: Returns the result object.
+        """ # noqa: E501
+
+        _param = self._list_alerts_serialize(
+            status=status,
+            attention=attention,
+            source_type=source_type,
+            integration_names=integration_names,
+            storm_id=storm_id,
+            q=q,
+            signal_severity=signal_severity,
+            alert_role=alert_role,
+            sort_by=sort_by,
+            page=page,
+            page_size=page_size,
+            _request_auth=_request_auth,
+            _content_type=_content_type,
+            _headers=_headers,
+            _host_index=_host_index
+        )
+
+        _response_types_map: Dict[str, Optional[str]] = {
+            '200': "ListAlertsResponse",
+        }
+        response_data = self.api_client.call_api(
+            *_param,
+            _request_timeout=_request_timeout
+        )
+        response_data.read()
+        return self.api_client.response_deserialize(
+            response_data=response_data,
+            response_types_map=_response_types_map,
+        )
+
+
+    @validate_call
+    def list_alerts_without_preload_content(
+        self,
+        status: Annotated[Optional[AlertStatus], Field(description="Filter by alert lifecycle status. Defaults to \"active\".")] = None,
+        attention: Annotated[Optional[AlertAttention], Field(description="Optional filter by triage attention category.")] = None,
+        source_type: Annotated[Optional[StrictStr], Field(description="Optional filter by alert source (e.g. \"grafana\").")] = None,
+        integration_names: Annotated[Optional[List[Annotated[str, Field(min_length=1, strict=True)]]], Field(description="Optional filter by one or more integration instance names (e.g. prod-grafana, sandbox-observenow). Summary counts and the alert list are scoped to these integrations when provided. ")] = None,
+        storm_id: Annotated[Optional[StrictStr], Field(description="Optional filter by correlated incident storm UUID. Returns all active alerts in the same ingest storm (for linked-alert navigation). ")] = None,
+        q: Annotated[Optional[StrictStr], Field(description="Optional case-insensitive search across alert titles and descriptions.")] = None,
+        signal_severity: Annotated[Optional[SignalSeverity], Field(description="Optional filter by normalized monitor signal severity (Critical, High, Medium, Low, info). Matches raw upstream source_severity values in each bucket before pagination. ")] = None,
+        alert_role: Annotated[Optional[AlertRole], Field(description="Optional filter by correlated alert role (root signal vs downstream effect). ")] = None,
+        sort_by: Annotated[Optional[AlertSortBy], Field(description="List ordering. `severity` (default) ranks by monitor display_priority. `impact` ranks by persisted blast-radius impact (env, scope, storm fanout) before severity as a tie-break. ")] = None,
+        page: Optional[Annotated[int, Field(strict=True, ge=1)]] = None,
+        page_size: Optional[Annotated[int, Field(le=500, strict=True, ge=1)]] = None,
+        _request_timeout: Union[
+            None,
+            Annotated[StrictFloat, Field(gt=0)],
+            Tuple[
+                Annotated[StrictFloat, Field(gt=0)],
+                Annotated[StrictFloat, Field(gt=0)]
+            ]
+        ] = None,
+        _request_auth: Optional[Dict[StrictStr, Any]] = None,
+        _content_type: Optional[StrictStr] = None,
+        _headers: Optional[Dict[StrictStr, Any]] = None,
+        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
+    ) -> RESTResponseType:
+        """List or count alerts with filters and summary totals
+
+        Returns a paginated alert inventory plus summary totals. Use this operation for \"list alerts\", \"count alerts\", firing-alert inventory, queue filtering, and alert searches. Read the response summary for counts instead of counting the current page. The summary is always for status=active; use `status` to switch the returned list between the Active tab (default) and Ignored tab. When listing titles and the tool result is truncated or compressed, read visible `id` values and call GET /api/v1/alerts/{id} (getAlertV1) per alert — do not invent titles. 
+
+        :param status: Filter by alert lifecycle status. Defaults to \"active\".
+        :type status: AlertStatus
+        :param attention: Optional filter by triage attention category.
+        :type attention: AlertAttention
+        :param source_type: Optional filter by alert source (e.g. \"grafana\").
+        :type source_type: str
+        :param integration_names: Optional filter by one or more integration instance names (e.g. prod-grafana, sandbox-observenow). Summary counts and the alert list are scoped to these integrations when provided. 
+        :type integration_names: List[str]
+        :param storm_id: Optional filter by correlated incident storm UUID. Returns all active alerts in the same ingest storm (for linked-alert navigation). 
+        :type storm_id: str
+        :param q: Optional case-insensitive search across alert titles and descriptions.
+        :type q: str
+        :param signal_severity: Optional filter by normalized monitor signal severity (Critical, High, Medium, Low, info). Matches raw upstream source_severity values in each bucket before pagination. 
+        :type signal_severity: SignalSeverity
+        :param alert_role: Optional filter by correlated alert role (root signal vs downstream effect). 
+        :type alert_role: AlertRole
+        :param sort_by: List ordering. `severity` (default) ranks by monitor display_priority. `impact` ranks by persisted blast-radius impact (env, scope, storm fanout) before severity as a tie-break. 
+        :type sort_by: AlertSortBy
+        :param page:
+        :type page: int
+        :param page_size:
+        :type page_size: int
+        :param _request_timeout: timeout setting for this request. If one
+                                 number provided, it will be total request
+                                 timeout. It can also be a pair (tuple) of
+                                 (connection, read) timeouts.
+        :type _request_timeout: int, tuple(int, int), optional
+        :param _request_auth: set to override the auth_settings for an a single
+                              request; this effectively ignores the
+                              authentication in the spec for a single request.
+        :type _request_auth: dict, optional
+        :param _content_type: force content-type for the request.
+        :type _content_type: str, Optional
+        :param _headers: set to override the headers for a single
+                         request; this effectively ignores the headers
+                         in the spec for a single request.
+        :type _headers: dict, optional
+        :param _host_index: set to override the host_index for a single
+                            request; this effectively ignores the host_index
+                            in the spec for a single request.
+        :type _host_index: int, optional
+        :return: Returns the result object.
+        """ # noqa: E501
+
+        _param = self._list_alerts_serialize(
+            status=status,
+            attention=attention,
+            source_type=source_type,
+            integration_names=integration_names,
+            storm_id=storm_id,
+            q=q,
+            signal_severity=signal_severity,
+            alert_role=alert_role,
+            sort_by=sort_by,
+            page=page,
+            page_size=page_size,
+            _request_auth=_request_auth,
+            _content_type=_content_type,
+            _headers=_headers,
+            _host_index=_host_index
+        )
+
+        _response_types_map: Dict[str, Optional[str]] = {
+            '200': "ListAlertsResponse",
+        }
+        response_data = self.api_client.call_api(
+            *_param,
+            _request_timeout=_request_timeout
+        )
+        return response_data.response
+
+
+    def _list_alerts_serialize(
+        self,
+        status,
+        attention,
+        source_type,
+        integration_names,
+        storm_id,
+        q,
+        signal_severity,
+        alert_role,
+        sort_by,
+        page,
+        page_size,
+        _request_auth,
+        _content_type,
+        _headers,
+        _host_index,
+    ) -> RequestSerialized:
+
+        _host = None
+
+        _collection_formats: Dict[str, str] = {
+            'integration_names': 'csv',
+        }
+
+        _path_params: Dict[str, str] = {}
+        _query_params: List[Tuple[str, str]] = []
+        _header_params: Dict[str, Optional[str]] = _headers or {}
+        _form_params: List[Tuple[str, str]] = []
+        _files: Dict[
+            str, Union[str, bytes, List[str], List[bytes], List[Tuple[str, bytes]]]
+        ] = {}
+        _body_params: Optional[bytes] = None
+
+        # process the path parameters
+        # process the query parameters
+        if status is not None:
+            
+            _query_params.append(('status', status.value))
+            
+        if attention is not None:
+            
+            _query_params.append(('attention', attention.value))
+            
+        if source_type is not None:
+            
+            _query_params.append(('source_type', source_type))
+            
+        if integration_names is not None:
+            
+            _query_params.append(('integration_names', integration_names))
+            
+        if storm_id is not None:
+            
+            _query_params.append(('storm_id', storm_id))
+            
+        if q is not None:
+            
+            _query_params.append(('q', q))
+            
+        if signal_severity is not None:
+            
+            _query_params.append(('signal_severity', signal_severity.value))
+            
+        if alert_role is not None:
+            
+            _query_params.append(('alert_role', alert_role.value))
+            
+        if sort_by is not None:
+            
+            _query_params.append(('sort_by', sort_by.value))
+            
+        if page is not None:
+            
+            _query_params.append(('page', page))
+            
+        if page_size is not None:
+            
+            _query_params.append(('page_size', page_size))
+            
+        # process the header parameters
+        # process the form parameters
+        # process the body parameter
+
+
+        # set the HTTP header `Accept`
+        if 'Accept' not in _header_params:
+            _header_params['Accept'] = self.api_client.select_header_accept(
+                [
+                    'application/json'
+                ]
+            )
+
+
+        # authentication setting
+        _auth_settings: List[str] = [
+            'ApiToken'
+        ]
+
+        return self.api_client.param_serialize(
+            method='GET',
+            resource_path='/app/sre/api/v1/alerts',
+            path_params=_path_params,
+            query_params=_query_params,
+            header_params=_header_params,
+            body=_body_params,
+            post_params=_form_params,
+            files=_files,
+            auth_settings=_auth_settings,
+            collection_formats=_collection_formats,
+            _host=_host,
+            _request_auth=_request_auth
+        )
+
+
+
+
+    @validate_call
+    def list_investigations(
+        self,
+        status: Annotated[Optional[InvestigationStatus], Field(description="Optional status filter.")] = None,
+        alert_id: Annotated[Optional[StrictStr], Field(description="Filter to investigations for a single alert (UUID).")] = None,
+        page: Optional[Annotated[int, Field(strict=True, ge=1)]] = None,
+        page_size: Optional[Annotated[int, Field(le=200, strict=True, ge=1)]] = None,
+        _request_timeout: Union[
+            None,
+            Annotated[StrictFloat, Field(gt=0)],
+            Tuple[
+                Annotated[StrictFloat, Field(gt=0)],
+                Annotated[StrictFloat, Field(gt=0)]
+            ]
+        ] = None,
+        _request_auth: Optional[Dict[StrictStr, Any]] = None,
+        _content_type: Optional[StrictStr] = None,
+        _headers: Optional[Dict[StrictStr, Any]] = None,
+        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
+    ) -> ListInvestigationsResponse:
+        """List or count investigations by status for the caller
+
+        Returns a paginated investigation inventory ordered by start time (most recent first) and scoped to the caller's tenant/owner. Use this operation for \"list investigations\", \"count investigations\", queued or completed investigation questions, and status re-checks. Read `total` for the full filtered count instead of counting the current page. Optional `status` narrows the result to one lifecycle bucket.
+
+        :param status: Optional status filter.
+        :type status: InvestigationStatus
+        :param alert_id: Filter to investigations for a single alert (UUID).
+        :type alert_id: str
+        :param page:
+        :type page: int
+        :param page_size:
+        :type page_size: int
+        :param _request_timeout: timeout setting for this request. If one
+                                 number provided, it will be total request
+                                 timeout. It can also be a pair (tuple) of
+                                 (connection, read) timeouts.
+        :type _request_timeout: int, tuple(int, int), optional
+        :param _request_auth: set to override the auth_settings for an a single
+                              request; this effectively ignores the
+                              authentication in the spec for a single request.
+        :type _request_auth: dict, optional
+        :param _content_type: force content-type for the request.
+        :type _content_type: str, Optional
+        :param _headers: set to override the headers for a single
+                         request; this effectively ignores the headers
+                         in the spec for a single request.
+        :type _headers: dict, optional
+        :param _host_index: set to override the host_index for a single
+                            request; this effectively ignores the host_index
+                            in the spec for a single request.
+        :type _host_index: int, optional
+        :return: Returns the result object.
+        """ # noqa: E501
+
+        _param = self._list_investigations_serialize(
+            status=status,
+            alert_id=alert_id,
+            page=page,
+            page_size=page_size,
+            _request_auth=_request_auth,
+            _content_type=_content_type,
+            _headers=_headers,
+            _host_index=_host_index
+        )
+
+        _response_types_map: Dict[str, Optional[str]] = {
+            '200': "ListInvestigationsResponse",
+        }
+        response_data = self.api_client.call_api(
+            *_param,
+            _request_timeout=_request_timeout
+        )
+        response_data.read()
+        return self.api_client.response_deserialize(
+            response_data=response_data,
+            response_types_map=_response_types_map,
+        ).data
+
+
+    @validate_call
+    def list_investigations_with_http_info(
+        self,
+        status: Annotated[Optional[InvestigationStatus], Field(description="Optional status filter.")] = None,
+        alert_id: Annotated[Optional[StrictStr], Field(description="Filter to investigations for a single alert (UUID).")] = None,
+        page: Optional[Annotated[int, Field(strict=True, ge=1)]] = None,
+        page_size: Optional[Annotated[int, Field(le=200, strict=True, ge=1)]] = None,
+        _request_timeout: Union[
+            None,
+            Annotated[StrictFloat, Field(gt=0)],
+            Tuple[
+                Annotated[StrictFloat, Field(gt=0)],
+                Annotated[StrictFloat, Field(gt=0)]
+            ]
+        ] = None,
+        _request_auth: Optional[Dict[StrictStr, Any]] = None,
+        _content_type: Optional[StrictStr] = None,
+        _headers: Optional[Dict[StrictStr, Any]] = None,
+        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
+    ) -> ApiResponse[ListInvestigationsResponse]:
+        """List or count investigations by status for the caller
+
+        Returns a paginated investigation inventory ordered by start time (most recent first) and scoped to the caller's tenant/owner. Use this operation for \"list investigations\", \"count investigations\", queued or completed investigation questions, and status re-checks. Read `total` for the full filtered count instead of counting the current page. Optional `status` narrows the result to one lifecycle bucket.
+
+        :param status: Optional status filter.
+        :type status: InvestigationStatus
+        :param alert_id: Filter to investigations for a single alert (UUID).
+        :type alert_id: str
+        :param page:
+        :type page: int
+        :param page_size:
+        :type page_size: int
+        :param _request_timeout: timeout setting for this request. If one
+                                 number provided, it will be total request
+                                 timeout. It can also be a pair (tuple) of
+                                 (connection, read) timeouts.
+        :type _request_timeout: int, tuple(int, int), optional
+        :param _request_auth: set to override the auth_settings for an a single
+                              request; this effectively ignores the
+                              authentication in the spec for a single request.
+        :type _request_auth: dict, optional
+        :param _content_type: force content-type for the request.
+        :type _content_type: str, Optional
+        :param _headers: set to override the headers for a single
+                         request; this effectively ignores the headers
+                         in the spec for a single request.
+        :type _headers: dict, optional
+        :param _host_index: set to override the host_index for a single
+                            request; this effectively ignores the host_index
+                            in the spec for a single request.
+        :type _host_index: int, optional
+        :return: Returns the result object.
+        """ # noqa: E501
+
+        _param = self._list_investigations_serialize(
+            status=status,
+            alert_id=alert_id,
+            page=page,
+            page_size=page_size,
+            _request_auth=_request_auth,
+            _content_type=_content_type,
+            _headers=_headers,
+            _host_index=_host_index
+        )
+
+        _response_types_map: Dict[str, Optional[str]] = {
+            '200': "ListInvestigationsResponse",
+        }
+        response_data = self.api_client.call_api(
+            *_param,
+            _request_timeout=_request_timeout
+        )
+        response_data.read()
+        return self.api_client.response_deserialize(
+            response_data=response_data,
+            response_types_map=_response_types_map,
+        )
+
+
+    @validate_call
+    def list_investigations_without_preload_content(
+        self,
+        status: Annotated[Optional[InvestigationStatus], Field(description="Optional status filter.")] = None,
+        alert_id: Annotated[Optional[StrictStr], Field(description="Filter to investigations for a single alert (UUID).")] = None,
+        page: Optional[Annotated[int, Field(strict=True, ge=1)]] = None,
+        page_size: Optional[Annotated[int, Field(le=200, strict=True, ge=1)]] = None,
+        _request_timeout: Union[
+            None,
+            Annotated[StrictFloat, Field(gt=0)],
+            Tuple[
+                Annotated[StrictFloat, Field(gt=0)],
+                Annotated[StrictFloat, Field(gt=0)]
+            ]
+        ] = None,
+        _request_auth: Optional[Dict[StrictStr, Any]] = None,
+        _content_type: Optional[StrictStr] = None,
+        _headers: Optional[Dict[StrictStr, Any]] = None,
+        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
+    ) -> RESTResponseType:
+        """List or count investigations by status for the caller
+
+        Returns a paginated investigation inventory ordered by start time (most recent first) and scoped to the caller's tenant/owner. Use this operation for \"list investigations\", \"count investigations\", queued or completed investigation questions, and status re-checks. Read `total` for the full filtered count instead of counting the current page. Optional `status` narrows the result to one lifecycle bucket.
+
+        :param status: Optional status filter.
+        :type status: InvestigationStatus
+        :param alert_id: Filter to investigations for a single alert (UUID).
+        :type alert_id: str
+        :param page:
+        :type page: int
+        :param page_size:
+        :type page_size: int
+        :param _request_timeout: timeout setting for this request. If one
+                                 number provided, it will be total request
+                                 timeout. It can also be a pair (tuple) of
+                                 (connection, read) timeouts.
+        :type _request_timeout: int, tuple(int, int), optional
+        :param _request_auth: set to override the auth_settings for an a single
+                              request; this effectively ignores the
+                              authentication in the spec for a single request.
+        :type _request_auth: dict, optional
+        :param _content_type: force content-type for the request.
+        :type _content_type: str, Optional
+        :param _headers: set to override the headers for a single
+                         request; this effectively ignores the headers
+                         in the spec for a single request.
+        :type _headers: dict, optional
+        :param _host_index: set to override the host_index for a single
+                            request; this effectively ignores the host_index
+                            in the spec for a single request.
+        :type _host_index: int, optional
+        :return: Returns the result object.
+        """ # noqa: E501
+
+        _param = self._list_investigations_serialize(
+            status=status,
+            alert_id=alert_id,
+            page=page,
+            page_size=page_size,
+            _request_auth=_request_auth,
+            _content_type=_content_type,
+            _headers=_headers,
+            _host_index=_host_index
+        )
+
+        _response_types_map: Dict[str, Optional[str]] = {
+            '200': "ListInvestigationsResponse",
+        }
+        response_data = self.api_client.call_api(
+            *_param,
+            _request_timeout=_request_timeout
+        )
+        return response_data.response
+
+
+    def _list_investigations_serialize(
+        self,
+        status,
+        alert_id,
+        page,
+        page_size,
+        _request_auth,
+        _content_type,
+        _headers,
+        _host_index,
+    ) -> RequestSerialized:
+
+        _host = None
+
+        _collection_formats: Dict[str, str] = {
+        }
+
+        _path_params: Dict[str, str] = {}
+        _query_params: List[Tuple[str, str]] = []
+        _header_params: Dict[str, Optional[str]] = _headers or {}
+        _form_params: List[Tuple[str, str]] = []
+        _files: Dict[
+            str, Union[str, bytes, List[str], List[bytes], List[Tuple[str, bytes]]]
+        ] = {}
+        _body_params: Optional[bytes] = None
+
+        # process the path parameters
+        # process the query parameters
+        if status is not None:
+            
+            _query_params.append(('status', status.value))
+            
+        if alert_id is not None:
+            
+            _query_params.append(('alert_id', alert_id))
+            
+        if page is not None:
+            
+            _query_params.append(('page', page))
+            
+        if page_size is not None:
+            
+            _query_params.append(('page_size', page_size))
+            
+        # process the header parameters
+        # process the form parameters
+        # process the body parameter
+
+
+        # set the HTTP header `Accept`
+        if 'Accept' not in _header_params:
+            _header_params['Accept'] = self.api_client.select_header_accept(
+                [
+                    'application/json'
+                ]
+            )
+
+
+        # authentication setting
+        _auth_settings: List[str] = [
+            'ApiToken'
+        ]
+
+        return self.api_client.param_serialize(
+            method='GET',
+            resource_path='/app/sre/api/v1/investigations',
+            path_params=_path_params,
+            query_params=_query_params,
+            header_params=_header_params,
+            body=_body_params,
+            post_params=_form_params,
+            files=_files,
+            auth_settings=_auth_settings,
+            collection_formats=_collection_formats,
+            _host=_host,
+            _request_auth=_request_auth
+        )
+
+