Release v1.1.1: Fix nullable enums, regenerate client

- Fix nullable enum properties handling null values from API
- Add post-generation fix script (tools/fix_nullable_enums.py)
- New incident list filters (functionality_names, service_names, team_names)
- New workflow tasks (MS Teams, Confluence, Datadog, Dropbox, Quip, SharePoint)
- Deprecate Catalog Entity Property endpoints
- Upstream bug filed: openapi-generators/openapi-python-client#1405

Author: kwent

CHANGELOG.md

@@ -7,6 +7,32 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.1.1] - 2025-02-25
+
+### Fixed
+- Nullable enum properties now correctly handle `null` values from the API ([#1405](https://github.com/openapi-generators/openapi-python-client/issues/1405))
+  - Added post-generation fix script (`tools/fix_nullable_enums.py`) to patch enum check functions
+  - Resolves `TypeError: Unexpected value None` when API returns null for nullable enum fields like `conditionable_type`
+
+### Added
+- New incident list filters: `filter[functionality_names]`, `filter[service_names]`, `filter[team_names]`
+- New workflow task types:
+  - `AddMicrosoftTeamsChatTabTaskParams` - Add tabs to Microsoft Teams chats
+  - `SendMicrosoftTeamsChatMessageTaskParams` - Send messages to Microsoft Teams chats
+  - `UpdateConfluencePageTaskParams` - Update Confluence pages
+  - `UpdateDatadogNotebookTaskParams` - Update Datadog notebooks
+  - `UpdateDropboxPaperPageTaskParams` - Update Dropbox Paper pages
+  - `UpdateQuipPageTaskParams` - Update Quip pages
+  - `UpdateSharepointPageTaskParams` - Update SharePoint pages
+- Alert route and alert group endpoint enhancements
+
+### Changed
+- Regenerated client from latest OpenAPI specification
+- Updated Makefile to automatically apply nullable enum fix after regeneration
+
+### Deprecated
+- Catalog Entity Property endpoints - use `fields` attribute on catalog entities or native catalog endpoints instead
+
 ## [1.1.0] - 2025-12-18
 
 ### Added

Makefile

@@ -39,6 +39,8 @@ regenerate:
 		--output-path . \
 		--overwrite \
 		--config tools/config.yaml
+	@echo "Applying nullable enum fix..."
+	@python tools/fix_nullable_enums.py
 
 test:
 	python -c "import rootly_sdk; print('SDK imports successfully')"

pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "rootly"
-version = "v1"
+version = "1.1.1"
 description = "A client library for accessing Rootly API v1"
 authors = []
 readme = "README.md"

rootly_sdk/api/alert_groups/create_alert_group.py

@@ -72,7 +72,9 @@ def sync_detailed(
 ) -> Response[Union[AlertGroupResponse, ErrorsList]]:
     """Creates an alert group
 
-     Creates a new alert group
+     Creates a new alert group. **Note**: For enhanced functionality and future compatibility, consider
+    using the advanced alert grouping with `conditions` field instead of the legacy
+    `group_by_alert_title`, `group_by_alert_urgency`, and `attributes` fields.
 
     Args:
         body (NewAlertGroup):
@@ -103,7 +105,9 @@ def sync(
 ) -> Optional[Union[AlertGroupResponse, ErrorsList]]:
     """Creates an alert group
 
-     Creates a new alert group
+     Creates a new alert group. **Note**: For enhanced functionality and future compatibility, consider
+    using the advanced alert grouping with `conditions` field instead of the legacy
+    `group_by_alert_title`, `group_by_alert_urgency`, and `attributes` fields.
 
     Args:
         body (NewAlertGroup):
@@ -129,7 +133,9 @@ async def asyncio_detailed(
 ) -> Response[Union[AlertGroupResponse, ErrorsList]]:
     """Creates an alert group
 
-     Creates a new alert group
+     Creates a new alert group. **Note**: For enhanced functionality and future compatibility, consider
+    using the advanced alert grouping with `conditions` field instead of the legacy
+    `group_by_alert_title`, `group_by_alert_urgency`, and `attributes` fields.
 
     Args:
         body (NewAlertGroup):
@@ -158,7 +164,9 @@ async def asyncio(
 ) -> Optional[Union[AlertGroupResponse, ErrorsList]]:
     """Creates an alert group
 
-     Creates a new alert group
+     Creates a new alert group. **Note**: For enhanced functionality and future compatibility, consider
+    using the advanced alert grouping with `conditions` field instead of the legacy
+    `group_by_alert_title`, `group_by_alert_urgency`, and `attributes` fields.
 
     Args:
         body (NewAlertGroup):

rootly_sdk/api/alert_groups/update_alert_group.py

@@ -70,7 +70,9 @@ def sync_detailed(
 ) -> Response[Union[AlertGroupResponse, ErrorsList]]:
     """Update an alert group
 
-     Update a specific alert group by id
+     Update a specific alert group by id. **Note**: For enhanced functionality and future compatibility,
+    consider using the advanced alert grouping with `conditions` field instead of the legacy
+    `group_by_alert_title`, `group_by_alert_urgency`, and `attributes` fields.
 
     Args:
         id (Union[UUID, str]):
@@ -104,7 +106,9 @@ def sync(
 ) -> Optional[Union[AlertGroupResponse, ErrorsList]]:
     """Update an alert group
 
-     Update a specific alert group by id
+     Update a specific alert group by id. **Note**: For enhanced functionality and future compatibility,
+    consider using the advanced alert grouping with `conditions` field instead of the legacy
+    `group_by_alert_title`, `group_by_alert_urgency`, and `attributes` fields.
 
     Args:
         id (Union[UUID, str]):
@@ -133,7 +137,9 @@ async def asyncio_detailed(
 ) -> Response[Union[AlertGroupResponse, ErrorsList]]:
     """Update an alert group
 
-     Update a specific alert group by id
+     Update a specific alert group by id. **Note**: For enhanced functionality and future compatibility,
+    consider using the advanced alert grouping with `conditions` field instead of the legacy
+    `group_by_alert_title`, `group_by_alert_urgency`, and `attributes` fields.
 
     Args:
         id (Union[UUID, str]):
@@ -165,7 +171,9 @@ async def asyncio(
 ) -> Optional[Union[AlertGroupResponse, ErrorsList]]:
     """Update an alert group
 
-     Update a specific alert group by id
+     Update a specific alert group by id. **Note**: For enhanced functionality and future compatibility,
+    consider using the advanced alert grouping with `conditions` field instead of the legacy
+    `group_by_alert_title`, `group_by_alert_urgency`, and `attributes` fields.
 
     Args:
         id (Union[UUID, str]):

rootly_sdk/api/alert_routes/get_alert_route.py

@@ -66,6 +66,14 @@ def sync_detailed(
      Get a specific alert route by id. **Note: This endpoint requires access to Advanced Alert Routing.
     If you're unsure whether you have access to this feature, please contact Rootly customer support.**
 
+    ## Optional Parameters
+
+    - **show_nested_ids** (query parameter): When set to `true`, the response will include IDs for all
+    nested resources (destinations, condition_groups, conditions). This is useful when you need to
+    reference these nested resources for updates or deletions via PATCH requests.
+
+    Example: `GET /v1/alert_routes/{id}?show_nested_ids=true`
+
     Args:
         id (str):
 
@@ -98,6 +106,14 @@ def sync(
      Get a specific alert route by id. **Note: This endpoint requires access to Advanced Alert Routing.
     If you're unsure whether you have access to this feature, please contact Rootly customer support.**
 
+    ## Optional Parameters
+
+    - **show_nested_ids** (query parameter): When set to `true`, the response will include IDs for all
+    nested resources (destinations, condition_groups, conditions). This is useful when you need to
+    reference these nested resources for updates or deletions via PATCH requests.
+
+    Example: `GET /v1/alert_routes/{id}?show_nested_ids=true`
+
     Args:
         id (str):
 
@@ -125,6 +141,14 @@ async def asyncio_detailed(
      Get a specific alert route by id. **Note: This endpoint requires access to Advanced Alert Routing.
     If you're unsure whether you have access to this feature, please contact Rootly customer support.**
 
+    ## Optional Parameters
+
+    - **show_nested_ids** (query parameter): When set to `true`, the response will include IDs for all
+    nested resources (destinations, condition_groups, conditions). This is useful when you need to
+    reference these nested resources for updates or deletions via PATCH requests.
+
+    Example: `GET /v1/alert_routes/{id}?show_nested_ids=true`
+
     Args:
         id (str):
 
@@ -155,6 +179,14 @@ async def asyncio(
      Get a specific alert route by id. **Note: This endpoint requires access to Advanced Alert Routing.
     If you're unsure whether you have access to this feature, please contact Rootly customer support.**
 
+    ## Optional Parameters
+
+    - **show_nested_ids** (query parameter): When set to `true`, the response will include IDs for all
+    nested resources (destinations, condition_groups, conditions). This is useful when you need to
+    reference these nested resources for updates or deletions via PATCH requests.
+
+    Example: `GET /v1/alert_routes/{id}?show_nested_ids=true`
+
     Args:
         id (str):
 

rootly_sdk/api/alert_routes/patch_alert_route.py

@@ -0,0 +1,201 @@
+from http import HTTPStatus
+from typing import Any, Optional, Union
+
+import httpx
+
+from ... import errors
+from ...client import AuthenticatedClient, Client
+from ...models.alert_route_response import AlertRouteResponse
+from ...models.errors_list import ErrorsList
+from ...models.patch_alert_route import PatchAlertRoute
+from ...types import Response
+
+
+def _get_kwargs(
+    id: str,
+    *,
+    body: PatchAlertRoute,
+) -> dict[str, Any]:
+    headers: dict[str, Any] = {}
+
+    _kwargs: dict[str, Any] = {
+        "method": "patch",
+        "url": f"/v1/alert_routes/{id}",
+    }
+
+    _kwargs["json"] = body.to_dict()
+
+    headers["Content-Type"] = "application/vnd.api+json"
+
+    _kwargs["headers"] = headers
+    return _kwargs
+
+
+def _parse_response(
+    *, client: Union[AuthenticatedClient, Client], response: httpx.Response
+) -> Optional[Union[AlertRouteResponse, ErrorsList]]:
+    if response.status_code == 200:
+        response_200 = AlertRouteResponse.from_dict(response.json())
+
+        return response_200
+
+    if response.status_code == 401:
+        response_401 = ErrorsList.from_dict(response.json())
+
+        return response_401
+
+    if response.status_code == 404:
+        response_404 = ErrorsList.from_dict(response.json())
+
+        return response_404
+
+    if response.status_code == 422:
+        response_422 = ErrorsList.from_dict(response.json())
+
+        return response_422
+
+    if client.raise_on_unexpected_status:
+        raise errors.UnexpectedStatus(response.status_code, response.content)
+    else:
+        return None
+
+
+def _build_response(
+    *, client: Union[AuthenticatedClient, Client], response: httpx.Response
+) -> Response[Union[AlertRouteResponse, ErrorsList]]:
+    return Response(
+        status_code=HTTPStatus(response.status_code),
+        content=response.content,
+        headers=response.headers,
+        parsed=_parse_response(client=client, response=response),
+    )
+
+
+def sync_detailed(
+    id: str,
+    *,
+    client: AuthenticatedClient,
+    body: PatchAlertRoute,
+) -> Response[Union[AlertRouteResponse, ErrorsList]]:
+    """Update an alert route
+
+     Updates an alert route. **Note: This endpoint requires access to Advanced Alert Routing. If you're
+    unsure whether you have access to this feature, please contact Rootly customer support.**
+
+    Args:
+        id (str):
+        body (PatchAlertRoute):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Response[Union[AlertRouteResponse, ErrorsList]]
+    """
+
+    kwargs = _get_kwargs(
+        id=id,
+        body=body,
+    )
+
+    response = client.get_httpx_client().request(
+        **kwargs,
+    )
+
+    return _build_response(client=client, response=response)
+
+
+def sync(
+    id: str,
+    *,
+    client: AuthenticatedClient,
+    body: PatchAlertRoute,
+) -> Optional[Union[AlertRouteResponse, ErrorsList]]:
+    """Update an alert route
+
+     Updates an alert route. **Note: This endpoint requires access to Advanced Alert Routing. If you're
+    unsure whether you have access to this feature, please contact Rootly customer support.**
+
+    Args:
+        id (str):
+        body (PatchAlertRoute):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Union[AlertRouteResponse, ErrorsList]
+    """
+
+    return sync_detailed(
+        id=id,
+        client=client,
+        body=body,
+    ).parsed
+
+
+async def asyncio_detailed(
+    id: str,
+    *,
+    client: AuthenticatedClient,
+    body: PatchAlertRoute,
+) -> Response[Union[AlertRouteResponse, ErrorsList]]:
+    """Update an alert route
+
+     Updates an alert route. **Note: This endpoint requires access to Advanced Alert Routing. If you're
+    unsure whether you have access to this feature, please contact Rootly customer support.**
+
+    Args:
+        id (str):
+        body (PatchAlertRoute):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Response[Union[AlertRouteResponse, ErrorsList]]
+    """
+
+    kwargs = _get_kwargs(
+        id=id,
+        body=body,
+    )
+
+    response = await client.get_async_httpx_client().request(**kwargs)
+
+    return _build_response(client=client, response=response)
+
+
+async def asyncio(
+    id: str,
+    *,
+    client: AuthenticatedClient,
+    body: PatchAlertRoute,
+) -> Optional[Union[AlertRouteResponse, ErrorsList]]:
+    """Update an alert route
+
+     Updates an alert route. **Note: This endpoint requires access to Advanced Alert Routing. If you're
+    unsure whether you have access to this feature, please contact Rootly customer support.**
+
+    Args:
+        id (str):
+        body (PatchAlertRoute):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Union[AlertRouteResponse, ErrorsList]
+    """
+
+    return (
+        await asyncio_detailed(
+            id=id,
+            client=client,
+            body=body,
+        )
+    ).parsed