brevo-python 4.0.1__py3-none-any.whl

brevo/external_feeds/raw_client.py

@@ -0,0 +1,1087 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import datetime as dt
+import typing
+from json.decoder import JSONDecodeError
+
+from ..core.api_error import ApiError
+from ..core.client_wrapper import AsyncClientWrapper, SyncClientWrapper
+from ..core.http_response import AsyncHttpResponse, HttpResponse
+from ..core.jsonable_encoder import jsonable_encoder
+from ..core.request_options import RequestOptions
+from ..core.serialization import convert_and_respect_annotation_metadata
+from ..core.unchecked_base_model import construct_type
+from ..errors.bad_request_error import BadRequestError
+from ..errors.not_found_error import NotFoundError
+from .types.create_external_feed_request_auth_type import CreateExternalFeedRequestAuthType
+from .types.create_external_feed_request_headers_item import CreateExternalFeedRequestHeadersItem
+from .types.create_external_feed_response import CreateExternalFeedResponse
+from .types.get_all_external_feeds_request_auth_type import GetAllExternalFeedsRequestAuthType
+from .types.get_all_external_feeds_request_sort import GetAllExternalFeedsRequestSort
+from .types.get_all_external_feeds_response import GetAllExternalFeedsResponse
+from .types.get_external_feed_by_uuid_response import GetExternalFeedByUuidResponse
+from .types.update_external_feed_request_auth_type import UpdateExternalFeedRequestAuthType
+from .types.update_external_feed_request_headers_item import UpdateExternalFeedRequestHeadersItem
+
+# this is used as the default value for optional parameters
+OMIT = typing.cast(typing.Any, ...)
+
+
+class RawExternalFeedsClient:
+    def __init__(self, *, client_wrapper: SyncClientWrapper):
+        self._client_wrapper = client_wrapper
+
+    def get_all_external_feeds(
+        self,
+        *,
+        search: typing.Optional[str] = None,
+        start_date: typing.Optional[dt.date] = None,
+        end_date: typing.Optional[dt.date] = None,
+        sort: typing.Optional[GetAllExternalFeedsRequestSort] = None,
+        auth_type: typing.Optional[GetAllExternalFeedsRequestAuthType] = None,
+        limit: typing.Optional[int] = None,
+        offset: typing.Optional[int] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> HttpResponse[GetAllExternalFeedsResponse]:
+        """
+        Retrieves all external feeds from your Brevo account with filtering and pagination.
+
+        **Use this to:**
+        - Get an overview of all external data feeds
+        - Find feeds by name using search functionality
+        - Filter feeds by creation date range
+        - Browse feeds by authentication type
+        - Monitor feed library organization and usage
+
+        **Key information returned:**
+        - Feed details (UUID, name, URL, authentication type)
+        - Feed configuration and settings
+        - Creation and modification timestamps
+        - Feed status and error information
+        - Authentication and header configurations
+
+        **Important considerations:**
+        - External feeds enable dynamic content in email campaigns
+        - Feeds must be accessible from Brevo servers
+        - Authentication credentials are securely stored
+        - Feed performance affects campaign delivery
+        - Use pagination for accounts with many feeds
+        - Date range filtering limited to 30 days maximum
+        - Search functionality works on feed name matching
+        - Internal feeds are system-managed and cannot be modified
+
+        Parameters
+        ----------
+        search : typing.Optional[str]
+            Can be used to filter records by search keyword on feed name
+
+        start_date : typing.Optional[dt.date]
+            Mandatory if `endDate` is used. Starting date (YYYY-MM-DD) from which
+            you want to fetch the list. Can be maximum 30 days older than current
+            date.
+
+        end_date : typing.Optional[dt.date]
+            Mandatory if `startDate` is used. Ending date (YYYY-MM-DD) till which
+            you want to fetch the list. Maximum time period that can be selected is
+            one month.
+
+        sort : typing.Optional[GetAllExternalFeedsRequestSort]
+            Sort the results in the ascending/descending order of record creation.
+            Default order is **descending** if `sort` is not passed.
+
+        auth_type : typing.Optional[GetAllExternalFeedsRequestAuthType]
+            Filter the records by `authType` of the feed.
+
+        limit : typing.Optional[int]
+            Number of documents returned per page.
+
+        offset : typing.Optional[int]
+            Index of the first document on the page.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        HttpResponse[GetAllExternalFeedsResponse]
+            External feeds retrieved successfully
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            "feeds",
+            method="GET",
+            params={
+                "search": search,
+                "startDate": str(start_date) if start_date is not None else None,
+                "endDate": str(end_date) if end_date is not None else None,
+                "sort": sort,
+                "authType": auth_type,
+                "limit": limit,
+                "offset": offset,
+            },
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    GetAllExternalFeedsResponse,
+                    construct_type(
+                        type_=GetAllExternalFeedsResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return HttpResponse(response=_response, data=_data)
+            if _response.status_code == 400:
+                raise BadRequestError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Any,
+                        construct_type(
+                            type_=typing.Any,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 404:
+                raise NotFoundError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Any,
+                        construct_type(
+                            type_=typing.Any,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
+    def create_external_feed(
+        self,
+        *,
+        name: str,
+        url: str,
+        auth_type: typing.Optional[CreateExternalFeedRequestAuthType] = OMIT,
+        username: typing.Optional[str] = OMIT,
+        password: typing.Optional[str] = OMIT,
+        token: typing.Optional[str] = OMIT,
+        max_retries: typing.Optional[int] = OMIT,
+        cache: typing.Optional[bool] = OMIT,
+        headers: typing.Optional[typing.Sequence[CreateExternalFeedRequestHeadersItem]] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> HttpResponse[CreateExternalFeedResponse]:
+        """
+        Creates a new external feed for dynamic content in email campaigns.
+
+        **Use this to:**
+        - Set up external data sources for dynamic content
+        - Configure authentication for protected feeds
+        - Enable real-time content updates in campaigns
+        - Establish connections to product catalogs, blogs, or APIs
+
+        **Key information returned:**
+        - Created feed UUID for reference in campaigns
+        - Success confirmation
+
+        **Important considerations:**
+        - Feed URL must be accessible from Brevo infrastructure
+        - Authentication credentials are securely encrypted
+        - Test feed accessibility before campaign use
+        - Consider feed response time for campaign performance
+        - Monitor feed reliability and uptime
+        - Use caching for frequently accessed feeds
+        - Maximum 5 retry attempts allowed for failed requests
+        - Custom headers support for API integration requirements
+
+        Parameters
+        ----------
+        name : str
+            Name of the feed
+
+        url : str
+            URL of the external data source
+
+        auth_type : typing.Optional[CreateExternalFeedRequestAuthType]
+            Authentication type for accessing the feed
+
+        username : typing.Optional[str]
+            Username for basic authentication (required if authType is 'basic')
+
+        password : typing.Optional[str]
+            Password for basic authentication (required if authType is 'basic')
+
+        token : typing.Optional[str]
+            Token for token-based authentication (required if authType is 'token')
+
+        max_retries : typing.Optional[int]
+            Maximum number of retry attempts for failed requests
+
+        cache : typing.Optional[bool]
+            Whether to cache the feed response
+
+        headers : typing.Optional[typing.Sequence[CreateExternalFeedRequestHeadersItem]]
+            Custom HTTP headers for the feed request
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        HttpResponse[CreateExternalFeedResponse]
+            External feed created successfully
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            "feeds",
+            method="POST",
+            json={
+                "name": name,
+                "url": url,
+                "authType": auth_type,
+                "username": username,
+                "password": password,
+                "token": token,
+                "maxRetries": max_retries,
+                "cache": cache,
+                "headers": convert_and_respect_annotation_metadata(
+                    object_=headers, annotation=typing.Sequence[CreateExternalFeedRequestHeadersItem], direction="write"
+                ),
+            },
+            headers={
+                "content-type": "application/json",
+            },
+            request_options=request_options,
+            omit=OMIT,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    CreateExternalFeedResponse,
+                    construct_type(
+                        type_=CreateExternalFeedResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return HttpResponse(response=_response, data=_data)
+            if _response.status_code == 400:
+                raise BadRequestError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Any,
+                        construct_type(
+                            type_=typing.Any,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
+    def get_external_feed_by_uuid(
+        self, uuid_: str, *, request_options: typing.Optional[RequestOptions] = None
+    ) -> HttpResponse[GetExternalFeedByUuidResponse]:
+        """
+        Retrieves details of a specific external feed by its UUID.
+
+        **Use this to:**
+        - Get complete configuration of an external feed
+        - Check feed authentication settings
+        - Review feed personalization options
+        - Verify feed URL and parameters
+        - Monitor feed modification history
+
+        **Key information returned:**
+        - Complete feed configuration and settings
+        - Authentication credentials and headers
+        - Personalization and fallback settings
+        - Creation and modification timestamps
+        - Cache and retry configurations
+
+        **Important considerations:**
+        - UUID must exist in your account
+        - Provides complete feed information for troubleshooting
+        - Essential before making modifications
+        - Shows current feed health status
+        - Useful for debugging feed issues
+
+        Parameters
+        ----------
+        uuid_ : str
+            UUID of the feed to fetch
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        HttpResponse[GetExternalFeedByUuidResponse]
+            External feed details retrieved successfully
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            f"feeds/{jsonable_encoder(uuid_)}",
+            method="GET",
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    GetExternalFeedByUuidResponse,
+                    construct_type(
+                        type_=GetExternalFeedByUuidResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return HttpResponse(response=_response, data=_data)
+            if _response.status_code == 400:
+                raise BadRequestError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Any,
+                        construct_type(
+                            type_=typing.Any,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 404:
+                raise NotFoundError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Any,
+                        construct_type(
+                            type_=typing.Any,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
+    def update_external_feed(
+        self,
+        uuid_: str,
+        *,
+        name: typing.Optional[str] = OMIT,
+        url: typing.Optional[str] = OMIT,
+        auth_type: typing.Optional[UpdateExternalFeedRequestAuthType] = OMIT,
+        username: typing.Optional[str] = OMIT,
+        password: typing.Optional[str] = OMIT,
+        token: typing.Optional[str] = OMIT,
+        headers: typing.Optional[typing.Sequence[UpdateExternalFeedRequestHeadersItem]] = OMIT,
+        max_retries: typing.Optional[int] = OMIT,
+        cache: typing.Optional[bool] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> HttpResponse[None]:
+        """
+        Updates configuration of an existing external feed.
+
+        **Use this to:**
+        - Update feed URLs when data sources change
+        - Modify authentication credentials
+        - Change cache and retry settings
+        - Update custom headers
+        - Rename feeds for better organization
+
+        **Key information returned:**
+        - Success confirmation message
+
+        **Important considerations:**
+        - Only provided fields will be updated
+        - Feed UUID must exist in your account
+        - Authentication changes require verification
+        - URL changes should be tested before campaign use
+        - Monitor campaigns using this feed after updates
+
+        Parameters
+        ----------
+        uuid_ : str
+            UUID of the feed to update
+
+        name : typing.Optional[str]
+            Name of the feed
+
+        url : typing.Optional[str]
+            URL of the external data source
+
+        auth_type : typing.Optional[UpdateExternalFeedRequestAuthType]
+            Authentication type for accessing the feed
+
+        username : typing.Optional[str]
+            Username for basic authentication
+
+        password : typing.Optional[str]
+            Password for basic authentication
+
+        token : typing.Optional[str]
+            Token for token-based authentication
+
+        headers : typing.Optional[typing.Sequence[UpdateExternalFeedRequestHeadersItem]]
+            Custom HTTP headers for the feed request
+
+        max_retries : typing.Optional[int]
+            Maximum number of retry attempts for failed requests
+
+        cache : typing.Optional[bool]
+            Whether to cache the feed response
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        HttpResponse[None]
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            f"feeds/{jsonable_encoder(uuid_)}",
+            method="PUT",
+            json={
+                "name": name,
+                "url": url,
+                "authType": auth_type,
+                "username": username,
+                "password": password,
+                "token": token,
+                "headers": convert_and_respect_annotation_metadata(
+                    object_=headers, annotation=typing.Sequence[UpdateExternalFeedRequestHeadersItem], direction="write"
+                ),
+                "maxRetries": max_retries,
+                "cache": cache,
+            },
+            headers={
+                "content-type": "application/json",
+            },
+            request_options=request_options,
+            omit=OMIT,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return HttpResponse(response=_response, data=None)
+            if _response.status_code == 400:
+                raise BadRequestError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Any,
+                        construct_type(
+                            type_=typing.Any,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 404:
+                raise NotFoundError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Any,
+                        construct_type(
+                            type_=typing.Any,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
+    def delete_external_feed(
+        self, uuid_: str, *, request_options: typing.Optional[RequestOptions] = None
+    ) -> HttpResponse[None]:
+        """
+        Deletes an external feed from your Brevo account.
+
+        **Use this to:**
+        - Remove external feeds that are no longer needed
+        - Clean up unused data sources
+        - Remove test or outdated feeds
+        - Maintain organized feed library
+
+        **Key information returned:**
+        - Success confirmation message
+
+        **Important considerations:**
+        - This action is PERMANENT and cannot be undone
+        - Feed configuration and history will be lost
+        - Check if feed is used in active campaigns before deletion
+        - Remove feed references from email templates
+        - Consider deactivating instead of deleting if unsure
+
+        Parameters
+        ----------
+        uuid_ : str
+            UUID of the feed to delete
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        HttpResponse[None]
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            f"feeds/{jsonable_encoder(uuid_)}",
+            method="DELETE",
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return HttpResponse(response=_response, data=None)
+            if _response.status_code == 400:
+                raise BadRequestError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Any,
+                        construct_type(
+                            type_=typing.Any,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 404:
+                raise NotFoundError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Any,
+                        construct_type(
+                            type_=typing.Any,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
+
+class AsyncRawExternalFeedsClient:
+    def __init__(self, *, client_wrapper: AsyncClientWrapper):
+        self._client_wrapper = client_wrapper
+
+    async def get_all_external_feeds(
+        self,
+        *,
+        search: typing.Optional[str] = None,
+        start_date: typing.Optional[dt.date] = None,
+        end_date: typing.Optional[dt.date] = None,
+        sort: typing.Optional[GetAllExternalFeedsRequestSort] = None,
+        auth_type: typing.Optional[GetAllExternalFeedsRequestAuthType] = None,
+        limit: typing.Optional[int] = None,
+        offset: typing.Optional[int] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> AsyncHttpResponse[GetAllExternalFeedsResponse]:
+        """
+        Retrieves all external feeds from your Brevo account with filtering and pagination.
+
+        **Use this to:**
+        - Get an overview of all external data feeds
+        - Find feeds by name using search functionality
+        - Filter feeds by creation date range
+        - Browse feeds by authentication type
+        - Monitor feed library organization and usage
+
+        **Key information returned:**
+        - Feed details (UUID, name, URL, authentication type)
+        - Feed configuration and settings
+        - Creation and modification timestamps
+        - Feed status and error information
+        - Authentication and header configurations
+
+        **Important considerations:**
+        - External feeds enable dynamic content in email campaigns
+        - Feeds must be accessible from Brevo servers
+        - Authentication credentials are securely stored
+        - Feed performance affects campaign delivery
+        - Use pagination for accounts with many feeds
+        - Date range filtering limited to 30 days maximum
+        - Search functionality works on feed name matching
+        - Internal feeds are system-managed and cannot be modified
+
+        Parameters
+        ----------
+        search : typing.Optional[str]
+            Can be used to filter records by search keyword on feed name
+
+        start_date : typing.Optional[dt.date]
+            Mandatory if `endDate` is used. Starting date (YYYY-MM-DD) from which
+            you want to fetch the list. Can be maximum 30 days older than current
+            date.
+
+        end_date : typing.Optional[dt.date]
+            Mandatory if `startDate` is used. Ending date (YYYY-MM-DD) till which
+            you want to fetch the list. Maximum time period that can be selected is
+            one month.
+
+        sort : typing.Optional[GetAllExternalFeedsRequestSort]
+            Sort the results in the ascending/descending order of record creation.
+            Default order is **descending** if `sort` is not passed.
+
+        auth_type : typing.Optional[GetAllExternalFeedsRequestAuthType]
+            Filter the records by `authType` of the feed.
+
+        limit : typing.Optional[int]
+            Number of documents returned per page.
+
+        offset : typing.Optional[int]
+            Index of the first document on the page.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        AsyncHttpResponse[GetAllExternalFeedsResponse]
+            External feeds retrieved successfully
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            "feeds",
+            method="GET",
+            params={
+                "search": search,
+                "startDate": str(start_date) if start_date is not None else None,
+                "endDate": str(end_date) if end_date is not None else None,
+                "sort": sort,
+                "authType": auth_type,
+                "limit": limit,
+                "offset": offset,
+            },
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    GetAllExternalFeedsResponse,
+                    construct_type(
+                        type_=GetAllExternalFeedsResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return AsyncHttpResponse(response=_response, data=_data)
+            if _response.status_code == 400:
+                raise BadRequestError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Any,
+                        construct_type(
+                            type_=typing.Any,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 404:
+                raise NotFoundError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Any,
+                        construct_type(
+                            type_=typing.Any,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
+    async def create_external_feed(
+        self,
+        *,
+        name: str,
+        url: str,
+        auth_type: typing.Optional[CreateExternalFeedRequestAuthType] = OMIT,
+        username: typing.Optional[str] = OMIT,
+        password: typing.Optional[str] = OMIT,
+        token: typing.Optional[str] = OMIT,
+        max_retries: typing.Optional[int] = OMIT,
+        cache: typing.Optional[bool] = OMIT,
+        headers: typing.Optional[typing.Sequence[CreateExternalFeedRequestHeadersItem]] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> AsyncHttpResponse[CreateExternalFeedResponse]:
+        """
+        Creates a new external feed for dynamic content in email campaigns.
+
+        **Use this to:**
+        - Set up external data sources for dynamic content
+        - Configure authentication for protected feeds
+        - Enable real-time content updates in campaigns
+        - Establish connections to product catalogs, blogs, or APIs
+
+        **Key information returned:**
+        - Created feed UUID for reference in campaigns
+        - Success confirmation
+
+        **Important considerations:**
+        - Feed URL must be accessible from Brevo infrastructure
+        - Authentication credentials are securely encrypted
+        - Test feed accessibility before campaign use
+        - Consider feed response time for campaign performance
+        - Monitor feed reliability and uptime
+        - Use caching for frequently accessed feeds
+        - Maximum 5 retry attempts allowed for failed requests
+        - Custom headers support for API integration requirements
+
+        Parameters
+        ----------
+        name : str
+            Name of the feed
+
+        url : str
+            URL of the external data source
+
+        auth_type : typing.Optional[CreateExternalFeedRequestAuthType]
+            Authentication type for accessing the feed
+
+        username : typing.Optional[str]
+            Username for basic authentication (required if authType is 'basic')
+
+        password : typing.Optional[str]
+            Password for basic authentication (required if authType is 'basic')
+
+        token : typing.Optional[str]
+            Token for token-based authentication (required if authType is 'token')
+
+        max_retries : typing.Optional[int]
+            Maximum number of retry attempts for failed requests
+
+        cache : typing.Optional[bool]
+            Whether to cache the feed response
+
+        headers : typing.Optional[typing.Sequence[CreateExternalFeedRequestHeadersItem]]
+            Custom HTTP headers for the feed request
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        AsyncHttpResponse[CreateExternalFeedResponse]
+            External feed created successfully
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            "feeds",
+            method="POST",
+            json={
+                "name": name,
+                "url": url,
+                "authType": auth_type,
+                "username": username,
+                "password": password,
+                "token": token,
+                "maxRetries": max_retries,
+                "cache": cache,
+                "headers": convert_and_respect_annotation_metadata(
+                    object_=headers, annotation=typing.Sequence[CreateExternalFeedRequestHeadersItem], direction="write"
+                ),
+            },
+            headers={
+                "content-type": "application/json",
+            },
+            request_options=request_options,
+            omit=OMIT,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    CreateExternalFeedResponse,
+                    construct_type(
+                        type_=CreateExternalFeedResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return AsyncHttpResponse(response=_response, data=_data)
+            if _response.status_code == 400:
+                raise BadRequestError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Any,
+                        construct_type(
+                            type_=typing.Any,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
+    async def get_external_feed_by_uuid(
+        self, uuid_: str, *, request_options: typing.Optional[RequestOptions] = None
+    ) -> AsyncHttpResponse[GetExternalFeedByUuidResponse]:
+        """
+        Retrieves details of a specific external feed by its UUID.
+
+        **Use this to:**
+        - Get complete configuration of an external feed
+        - Check feed authentication settings
+        - Review feed personalization options
+        - Verify feed URL and parameters
+        - Monitor feed modification history
+
+        **Key information returned:**
+        - Complete feed configuration and settings
+        - Authentication credentials and headers
+        - Personalization and fallback settings
+        - Creation and modification timestamps
+        - Cache and retry configurations
+
+        **Important considerations:**
+        - UUID must exist in your account
+        - Provides complete feed information for troubleshooting
+        - Essential before making modifications
+        - Shows current feed health status
+        - Useful for debugging feed issues
+
+        Parameters
+        ----------
+        uuid_ : str
+            UUID of the feed to fetch
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        AsyncHttpResponse[GetExternalFeedByUuidResponse]
+            External feed details retrieved successfully
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            f"feeds/{jsonable_encoder(uuid_)}",
+            method="GET",
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    GetExternalFeedByUuidResponse,
+                    construct_type(
+                        type_=GetExternalFeedByUuidResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return AsyncHttpResponse(response=_response, data=_data)
+            if _response.status_code == 400:
+                raise BadRequestError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Any,
+                        construct_type(
+                            type_=typing.Any,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 404:
+                raise NotFoundError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Any,
+                        construct_type(
+                            type_=typing.Any,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
+    async def update_external_feed(
+        self,
+        uuid_: str,
+        *,
+        name: typing.Optional[str] = OMIT,
+        url: typing.Optional[str] = OMIT,
+        auth_type: typing.Optional[UpdateExternalFeedRequestAuthType] = OMIT,
+        username: typing.Optional[str] = OMIT,
+        password: typing.Optional[str] = OMIT,
+        token: typing.Optional[str] = OMIT,
+        headers: typing.Optional[typing.Sequence[UpdateExternalFeedRequestHeadersItem]] = OMIT,
+        max_retries: typing.Optional[int] = OMIT,
+        cache: typing.Optional[bool] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> AsyncHttpResponse[None]:
+        """
+        Updates configuration of an existing external feed.
+
+        **Use this to:**
+        - Update feed URLs when data sources change
+        - Modify authentication credentials
+        - Change cache and retry settings
+        - Update custom headers
+        - Rename feeds for better organization
+
+        **Key information returned:**
+        - Success confirmation message
+
+        **Important considerations:**
+        - Only provided fields will be updated
+        - Feed UUID must exist in your account
+        - Authentication changes require verification
+        - URL changes should be tested before campaign use
+        - Monitor campaigns using this feed after updates
+
+        Parameters
+        ----------
+        uuid_ : str
+            UUID of the feed to update
+
+        name : typing.Optional[str]
+            Name of the feed
+
+        url : typing.Optional[str]
+            URL of the external data source
+
+        auth_type : typing.Optional[UpdateExternalFeedRequestAuthType]
+            Authentication type for accessing the feed
+
+        username : typing.Optional[str]
+            Username for basic authentication
+
+        password : typing.Optional[str]
+            Password for basic authentication
+
+        token : typing.Optional[str]
+            Token for token-based authentication
+
+        headers : typing.Optional[typing.Sequence[UpdateExternalFeedRequestHeadersItem]]
+            Custom HTTP headers for the feed request
+
+        max_retries : typing.Optional[int]
+            Maximum number of retry attempts for failed requests
+
+        cache : typing.Optional[bool]
+            Whether to cache the feed response
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        AsyncHttpResponse[None]
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            f"feeds/{jsonable_encoder(uuid_)}",
+            method="PUT",
+            json={
+                "name": name,
+                "url": url,
+                "authType": auth_type,
+                "username": username,
+                "password": password,
+                "token": token,
+                "headers": convert_and_respect_annotation_metadata(
+                    object_=headers, annotation=typing.Sequence[UpdateExternalFeedRequestHeadersItem], direction="write"
+                ),
+                "maxRetries": max_retries,
+                "cache": cache,
+            },
+            headers={
+                "content-type": "application/json",
+            },
+            request_options=request_options,
+            omit=OMIT,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return AsyncHttpResponse(response=_response, data=None)
+            if _response.status_code == 400:
+                raise BadRequestError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Any,
+                        construct_type(
+                            type_=typing.Any,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 404:
+                raise NotFoundError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Any,
+                        construct_type(
+                            type_=typing.Any,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
+    async def delete_external_feed(
+        self, uuid_: str, *, request_options: typing.Optional[RequestOptions] = None
+    ) -> AsyncHttpResponse[None]:
+        """
+        Deletes an external feed from your Brevo account.
+
+        **Use this to:**
+        - Remove external feeds that are no longer needed
+        - Clean up unused data sources
+        - Remove test or outdated feeds
+        - Maintain organized feed library
+
+        **Key information returned:**
+        - Success confirmation message
+
+        **Important considerations:**
+        - This action is PERMANENT and cannot be undone
+        - Feed configuration and history will be lost
+        - Check if feed is used in active campaigns before deletion
+        - Remove feed references from email templates
+        - Consider deactivating instead of deleting if unsure
+
+        Parameters
+        ----------
+        uuid_ : str
+            UUID of the feed to delete
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        AsyncHttpResponse[None]
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            f"feeds/{jsonable_encoder(uuid_)}",
+            method="DELETE",
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return AsyncHttpResponse(response=_response, data=None)
+            if _response.status_code == 400:
+                raise BadRequestError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Any,
+                        construct_type(
+                            type_=typing.Any,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 404:
+                raise NotFoundError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Any,
+                        construct_type(
+                            type_=typing.Any,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)