samsara-api 4.1.0__tar.gz → 4.2.0__tar.gz

{samsara_api-4.1.0 → samsara_api-4.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: samsara-api
-Version: 4.1.0
+Version: 4.2.0
 Summary: 
 License: MIT
 Requires-Python: >=3.8,<4.0

{samsara_api-4.1.0 → samsara_api-4.2.0}/pyproject.toml

@@ -3,7 +3,7 @@ name = "samsara-api"
 
 [tool.poetry]
 name = "samsara-api"
-version = "4.1.0"
+version = "4.2.0"
 description = ""
 readme = "README.md"
 authors = []

{samsara_api-4.1.0 → samsara_api-4.2.0}/src/samsara/__init__.py

@@ -1308,8 +1308,11 @@ if typing.TYPE_CHECKING:
         HubsListHubsTooManyRequestsErrorResponseBody,
         HubsListHubsUnauthorizedErrorResponseBody,
         IdleTimeDurationMs,
-        IdlingEventObjectResponseBody,
-        IdlingEventObjectResponseBodyAddressType,
+        IdlingEventAddressObjectResponseBody,
+        IdlingEventAddressObjectResponseBodyAddressTypesItem,
+        IdlingEventAssetObjectResponseBody,
+        IdlingEventObjectV20251023ResponseBody,
+        IdlingEventOperatorObjectResponseBody,
         IdlingReportEventAddressResponseBody,
         IdlingReportEventResponseBody,
         IdlingReportsGetVehicleIdlingReportsBadGatewayErrorResponseBody,
@@ -4675,8 +4678,11 @@ _dynamic_imports: typing.Dict[str, str] = {
     "HubsListHubsTooManyRequestsErrorResponseBody": ".types",
     "HubsListHubsUnauthorizedErrorResponseBody": ".types",
     "IdleTimeDurationMs": ".types",
-    "IdlingEventObjectResponseBody": ".types",
-    "IdlingEventObjectResponseBodyAddressType": ".types",
+    "IdlingEventAddressObjectResponseBody": ".types",
+    "IdlingEventAddressObjectResponseBodyAddressTypesItem": ".types",
+    "IdlingEventAssetObjectResponseBody": ".types",
+    "IdlingEventObjectV20251023ResponseBody": ".types",
+    "IdlingEventOperatorObjectResponseBody": ".types",
     "IdlingReportEventAddressResponseBody": ".types",
     "IdlingReportEventResponseBody": ".types",
     "IdlingReportsGetVehicleIdlingReportsBadGatewayErrorResponseBody": ".types",
@@ -7982,8 +7988,11 @@ __all__ = [
     "HubsListHubsTooManyRequestsErrorResponseBody",
     "HubsListHubsUnauthorizedErrorResponseBody",
     "IdleTimeDurationMs",
-    "IdlingEventObjectResponseBody",
-    "IdlingEventObjectResponseBodyAddressType",
+    "IdlingEventAddressObjectResponseBody",
+    "IdlingEventAddressObjectResponseBodyAddressTypesItem",
+    "IdlingEventAssetObjectResponseBody",
+    "IdlingEventObjectV20251023ResponseBody",
+    "IdlingEventOperatorObjectResponseBody",
     "IdlingReportEventAddressResponseBody",
     "IdlingReportEventResponseBody",
     "IdlingReportsGetVehicleIdlingReportsBadGatewayErrorResponseBody",

{samsara_api-4.1.0 → samsara_api-4.2.0}/src/samsara/beta_ap_is/client.py

@@ -947,7 +947,7 @@ class BetaApIsClient:
             relay_states=[
                 UpdateEngineImmobilizerRelayStateRequestBodyRequestBody(
                     id="relay1",
-                    is_open=True,
+                    is_open=False,
                 )
             ],
         )
@@ -4326,7 +4326,7 @@ class AsyncBetaApIsClient:
                 relay_states=[
                     UpdateEngineImmobilizerRelayStateRequestBodyRequestBody(
                         id="relay1",
-                        is_open=True,
+                        is_open=False,
                     )
                 ],
             )

{samsara_api-4.1.0 → samsara_api-4.2.0}/src/samsara/core/client_wrapper.py

@@ -22,10 +22,10 @@ class BaseClientWrapper:
 
     def get_headers(self) -> typing.Dict[str, str]:
         headers: typing.Dict[str, str] = {
-            "User-Agent": "samsara-api/4.1.0",
+            "User-Agent": "samsara-api/4.2.0",
             "X-Fern-Language": "Python",
             "X-Fern-SDK-Name": "samsara-api",
-            "X-Fern-SDK-Version": "4.1.0",
+            "X-Fern-SDK-Version": "4.2.0",
             **(self.get_custom_headers() or {}),
         }
         token = self._get_token()

{samsara_api-4.1.0 → samsara_api-4.2.0}/src/samsara/idling/client.py

@@ -39,6 +39,7 @@ class IdlingClient:
         max_duration_milliseconds: typing.Optional[int] = None,
         tag_ids: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
         parent_tag_ids: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
+        include_external_ids: typing.Optional[bool] = None,
         after: typing.Optional[str] = None,
         limit: typing.Optional[int] = None,
         request_options: typing.Optional[RequestOptions] = None,
@@ -93,6 +94,9 @@ class IdlingClient:
         parent_tag_ids : typing.Optional[typing.Union[str, typing.Sequence[str]]]
             A filter on the data based on this comma-separated list of parent tag IDs. Parent tag IDs only include vehicle IDs at this time.
 
+        include_external_ids : typing.Optional[bool]
+            Optional boolean indicating whether to return external IDs on supported entities
+
         after : typing.Optional[str]
              If specified, this should be the endCursor value from the previous page of results. When present, this request will return the next page of results that occur immediately after the previous page of results.
 
@@ -123,6 +127,7 @@ class IdlingClient:
             exclude_events_with_unknown_air_temperature=True,
             min_duration_milliseconds=1,
             max_duration_milliseconds=1,
+            include_external_ids=True,
             after="after",
             limit=1,
         )
@@ -140,6 +145,7 @@ class IdlingClient:
             max_duration_milliseconds=max_duration_milliseconds,
             tag_ids=tag_ids,
             parent_tag_ids=parent_tag_ids,
+            include_external_ids=include_external_ids,
             after=after,
             limit=limit,
             request_options=request_options,
@@ -177,6 +183,7 @@ class AsyncIdlingClient:
         max_duration_milliseconds: typing.Optional[int] = None,
         tag_ids: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
         parent_tag_ids: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
+        include_external_ids: typing.Optional[bool] = None,
         after: typing.Optional[str] = None,
         limit: typing.Optional[int] = None,
         request_options: typing.Optional[RequestOptions] = None,
@@ -231,6 +238,9 @@ class AsyncIdlingClient:
         parent_tag_ids : typing.Optional[typing.Union[str, typing.Sequence[str]]]
             A filter on the data based on this comma-separated list of parent tag IDs. Parent tag IDs only include vehicle IDs at this time.
 
+        include_external_ids : typing.Optional[bool]
+            Optional boolean indicating whether to return external IDs on supported entities
+
         after : typing.Optional[str]
              If specified, this should be the endCursor value from the previous page of results. When present, this request will return the next page of results that occur immediately after the previous page of results.
 
@@ -266,6 +276,7 @@ class AsyncIdlingClient:
                 exclude_events_with_unknown_air_temperature=True,
                 min_duration_milliseconds=1,
                 max_duration_milliseconds=1,
+                include_external_ids=True,
                 after="after",
                 limit=1,
             )
@@ -286,6 +297,7 @@ class AsyncIdlingClient:
             max_duration_milliseconds=max_duration_milliseconds,
             tag_ids=tag_ids,
             parent_tag_ids=parent_tag_ids,
+            include_external_ids=include_external_ids,
             after=after,
             limit=limit,
             request_options=request_options,

{samsara_api-4.1.0 → samsara_api-4.2.0}/src/samsara/idling/raw_client.py

@@ -40,6 +40,7 @@ class RawIdlingClient:
         max_duration_milliseconds: typing.Optional[int] = None,
         tag_ids: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
         parent_tag_ids: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
+        include_external_ids: typing.Optional[bool] = None,
         after: typing.Optional[str] = None,
         limit: typing.Optional[int] = None,
         request_options: typing.Optional[RequestOptions] = None,
@@ -94,6 +95,9 @@ class RawIdlingClient:
         parent_tag_ids : typing.Optional[typing.Union[str, typing.Sequence[str]]]
             A filter on the data based on this comma-separated list of parent tag IDs. Parent tag IDs only include vehicle IDs at this time.
 
+        include_external_ids : typing.Optional[bool]
+            Optional boolean indicating whether to return external IDs on supported entities
+
         after : typing.Optional[str]
              If specified, this should be the endCursor value from the previous page of results. When present, this request will return the next page of results that occur immediately after the previous page of results.
 
@@ -124,6 +128,7 @@ class RawIdlingClient:
                 "maxDurationMilliseconds": max_duration_milliseconds,
                 "tagIds": tag_ids,
                 "parentTagIds": parent_tag_ids,
+                "includeExternalIds": include_external_ids,
                 "after": after,
                 "limit": limit,
             },
@@ -263,6 +268,7 @@ class AsyncRawIdlingClient:
         max_duration_milliseconds: typing.Optional[int] = None,
         tag_ids: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
         parent_tag_ids: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
+        include_external_ids: typing.Optional[bool] = None,
         after: typing.Optional[str] = None,
         limit: typing.Optional[int] = None,
         request_options: typing.Optional[RequestOptions] = None,
@@ -317,6 +323,9 @@ class AsyncRawIdlingClient:
         parent_tag_ids : typing.Optional[typing.Union[str, typing.Sequence[str]]]
             A filter on the data based on this comma-separated list of parent tag IDs. Parent tag IDs only include vehicle IDs at this time.
 
+        include_external_ids : typing.Optional[bool]
+            Optional boolean indicating whether to return external IDs on supported entities
+
         after : typing.Optional[str]
              If specified, this should be the endCursor value from the previous page of results. When present, this request will return the next page of results that occur immediately after the previous page of results.
 
@@ -347,6 +356,7 @@ class AsyncRawIdlingClient:
                 "maxDurationMilliseconds": max_duration_milliseconds,
                 "tagIds": tag_ids,
                 "parentTagIds": parent_tag_ids,
+                "includeExternalIds": include_external_ids,
                 "after": after,
                 "limit": limit,
             },

{samsara_api-4.1.0 → samsara_api-4.2.0}/src/samsara/media/client.py

@@ -226,12 +226,7 @@ class MediaClient:
         )
         client.media.post_media_retrieval(
             end_time="2019-06-13T19:08:55Z",
-            inputs=[
-                "dashcamRoadFacing",
-                "dashcamRoadFacing",
-                "dashcamRoadFacing",
-                "dashcamRoadFacing",
-            ],
+            inputs=["dashcamRoadFacing", "dashcamRoadFacing"],
             media_type="image",
             start_time="2019-06-13T19:08:25Z",
             vehicle_id="1234",
@@ -475,12 +470,7 @@ class AsyncMediaClient:
         async def main() -> None:
             await client.media.post_media_retrieval(
                 end_time="2019-06-13T19:08:55Z",
-                inputs=[
-                    "dashcamRoadFacing",
-                    "dashcamRoadFacing",
-                    "dashcamRoadFacing",
-                    "dashcamRoadFacing",
-                ],
+                inputs=["dashcamRoadFacing", "dashcamRoadFacing"],
                 media_type="image",
                 start_time="2019-06-13T19:08:25Z",
                 vehicle_id="1234",

{samsara_api-4.1.0 → samsara_api-4.2.0}/src/samsara/types/__init__.py

@@ -2629,8 +2629,13 @@ if typing.TYPE_CHECKING:
     from .hubs_list_hubs_too_many_requests_error_response_body import HubsListHubsTooManyRequestsErrorResponseBody
     from .hubs_list_hubs_unauthorized_error_response_body import HubsListHubsUnauthorizedErrorResponseBody
     from .idle_time_duration_ms import IdleTimeDurationMs
-    from .idling_event_object_response_body import IdlingEventObjectResponseBody
-    from .idling_event_object_response_body_address_type import IdlingEventObjectResponseBodyAddressType
+    from .idling_event_address_object_response_body import IdlingEventAddressObjectResponseBody
+    from .idling_event_address_object_response_body_address_types_item import (
+        IdlingEventAddressObjectResponseBodyAddressTypesItem,
+    )
+    from .idling_event_asset_object_response_body import IdlingEventAssetObjectResponseBody
+    from .idling_event_object_v_20251023_response_body import IdlingEventObjectV20251023ResponseBody
+    from .idling_event_operator_object_response_body import IdlingEventOperatorObjectResponseBody
     from .idling_report_event_address_response_body import IdlingReportEventAddressResponseBody
     from .idling_report_event_response_body import IdlingReportEventResponseBody
     from .idling_reports_get_vehicle_idling_reports_bad_gateway_error_response_body import (
@@ -7474,8 +7479,11 @@ _dynamic_imports: typing.Dict[str, str] = {
     "HubsListHubsTooManyRequestsErrorResponseBody": ".hubs_list_hubs_too_many_requests_error_response_body",
     "HubsListHubsUnauthorizedErrorResponseBody": ".hubs_list_hubs_unauthorized_error_response_body",
     "IdleTimeDurationMs": ".idle_time_duration_ms",
-    "IdlingEventObjectResponseBody": ".idling_event_object_response_body",
-    "IdlingEventObjectResponseBodyAddressType": ".idling_event_object_response_body_address_type",
+    "IdlingEventAddressObjectResponseBody": ".idling_event_address_object_response_body",
+    "IdlingEventAddressObjectResponseBodyAddressTypesItem": ".idling_event_address_object_response_body_address_types_item",
+    "IdlingEventAssetObjectResponseBody": ".idling_event_asset_object_response_body",
+    "IdlingEventObjectV20251023ResponseBody": ".idling_event_object_v_20251023_response_body",
+    "IdlingEventOperatorObjectResponseBody": ".idling_event_operator_object_response_body",
     "IdlingReportEventAddressResponseBody": ".idling_report_event_address_response_body",
     "IdlingReportEventResponseBody": ".idling_report_event_response_body",
     "IdlingReportsGetVehicleIdlingReportsBadGatewayErrorResponseBody": ".idling_reports_get_vehicle_idling_reports_bad_gateway_error_response_body",
@@ -10627,8 +10635,11 @@ __all__ = [
     "HubsListHubsTooManyRequestsErrorResponseBody",
     "HubsListHubsUnauthorizedErrorResponseBody",
     "IdleTimeDurationMs",
-    "IdlingEventObjectResponseBody",
-    "IdlingEventObjectResponseBodyAddressType",
+    "IdlingEventAddressObjectResponseBody",
+    "IdlingEventAddressObjectResponseBodyAddressTypesItem",
+    "IdlingEventAssetObjectResponseBody",
+    "IdlingEventObjectV20251023ResponseBody",
+    "IdlingEventOperatorObjectResponseBody",
     "IdlingReportEventAddressResponseBody",
     "IdlingReportEventResponseBody",
     "IdlingReportsGetVehicleIdlingReportsBadGatewayErrorResponseBody",

{samsara_api-4.1.0 → samsara_api-4.2.0}/src/samsara/types/advanced_idling_get_idling_events_response_body.py

@@ -5,11 +5,11 @@ import typing
 import pydantic
 from ..core.pydantic_utilities import IS_PYDANTIC_V2, UniversalBaseModel
 from .goa_pagination_response_response_body import GoaPaginationResponseResponseBody
-from .idling_event_object_response_body import IdlingEventObjectResponseBody
+from .idling_event_object_v_20251023_response_body import IdlingEventObjectV20251023ResponseBody
 
 
 class AdvancedIdlingGetIdlingEventsResponseBody(UniversalBaseModel):
-    data: typing.List[IdlingEventObjectResponseBody] = pydantic.Field()
+    data: typing.List[IdlingEventObjectV20251023ResponseBody] = pydantic.Field()
     """
     List of idling event objects.
     """

{samsara_api-4.1.0 → samsara_api-4.2.0}/src/samsara/types/harsh_event_trigger_details_object_request_body_types_item.py

@@ -39,6 +39,7 @@ HarshEventTriggerDetailsObjectRequestBodyTypesItem = typing.Union[
         "haTailgating",
         "haTileRollingRailroadCrossing",
         "haTileRollingStopSign",
+        "haTrafficLightDetection",
         "haUnsafeParking",
         "haVulnerableRoadUserCollisionWarning",
         "haYawControlBrakeControlActivated",

{samsara_api-4.1.0 → samsara_api-4.2.0}/src/samsara/types/harsh_event_trigger_details_object_response_body_types_item.py

@@ -39,6 +39,7 @@ HarshEventTriggerDetailsObjectResponseBodyTypesItem = typing.Union[
         "haTailgating",
         "haTileRollingRailroadCrossing",
         "haTileRollingStopSign",
+        "haTrafficLightDetection",
         "haUnsafeParking",
         "haVulnerableRoadUserCollisionWarning",
         "haYawControlBrakeControlActivated",

samsara_api-4.2.0/src/samsara/types/idling_event_address_object_response_body.py

@@ -0,0 +1,46 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+import pydantic
+import typing_extensions
+from ..core.pydantic_utilities import IS_PYDANTIC_V2, UniversalBaseModel
+from ..core.serialization import FieldMetadata
+from .idling_event_address_object_response_body_address_types_item import (
+    IdlingEventAddressObjectResponseBodyAddressTypesItem,
+)
+
+
+class IdlingEventAddressObjectResponseBody(UniversalBaseModel):
+    """
+    The geofence address associated with the idling event, if applicable.
+    """
+
+    address_types: typing_extensions.Annotated[
+        typing.Optional[typing.List[IdlingEventAddressObjectResponseBodyAddressTypesItem]],
+        FieldMetadata(alias="addressTypes"),
+    ] = pydantic.Field(default=None)
+    """
+    The types of the geofence address of the idling location. An address can have multiple types.
+    """
+
+    external_ids: typing_extensions.Annotated[
+        typing.Optional[typing.Dict[str, str]], FieldMetadata(alias="externalIds")
+    ] = pydantic.Field(default=None)
+    """
+    A map of external ids for the address.
+    """
+
+    id: str = pydantic.Field()
+    """
+    The ID of the geofence address of the idling location. It will be the address at the time of idling.
+    """
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow

samsara_api-4.1.0/src/samsara/types/idling_event_object_response_body_address_type.py → samsara_api-4.2.0/src/samsara/types/idling_event_address_object_response_body_address_types_item.py

@@ -2,7 +2,7 @@
 
 import typing
 
-IdlingEventObjectResponseBodyAddressType = typing.Union[
+IdlingEventAddressObjectResponseBodyAddressTypesItem = typing.Union[
     typing.Literal[
         "agricultureSource",
         "alertsOnly",

samsara_api-4.2.0/src/samsara/types/idling_event_asset_object_response_body.py

@@ -0,0 +1,35 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+import pydantic
+import typing_extensions
+from ..core.pydantic_utilities import IS_PYDANTIC_V2, UniversalBaseModel
+from ..core.serialization import FieldMetadata
+
+
+class IdlingEventAssetObjectResponseBody(UniversalBaseModel):
+    """
+    The asset associated with the idling event. Returns vehicle details at this time.
+    """
+
+    external_ids: typing_extensions.Annotated[
+        typing.Optional[typing.Dict[str, str]], FieldMetadata(alias="externalIds")
+    ] = pydantic.Field(default=None)
+    """
+    A map of external ids for the asset.
+    """
+
+    id: int = pydantic.Field()
+    """
+    Samsara ID of the asset assigned to the event. Returns vehicle ID at this time.
+    """
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow

samsara_api-4.1.0/src/samsara/types/idling_event_object_response_body.py → samsara_api-4.2.0/src/samsara/types/idling_event_object_v_20251023_response_body.py

@@ -8,28 +8,17 @@ from ..core.pydantic_utilities import IS_PYDANTIC_V2, UniversalBaseModel
 from ..core.serialization import FieldMetadata
 from .fuel_cost_object_response_body import FuelCostObjectResponseBody
 from .gaseous_fuel_cost_object_response_body import GaseousFuelCostObjectResponseBody
-from .idling_event_object_response_body_address_type import IdlingEventObjectResponseBodyAddressType
+from .idling_event_address_object_response_body import IdlingEventAddressObjectResponseBody
+from .idling_event_asset_object_response_body import IdlingEventAssetObjectResponseBody
+from .idling_event_operator_object_response_body import IdlingEventOperatorObjectResponseBody
 
 
-class IdlingEventObjectResponseBody(UniversalBaseModel):
+class IdlingEventObjectV20251023ResponseBody(UniversalBaseModel):
     """
     An idling event object.
     """
 
-    address_id: typing_extensions.Annotated[typing.Optional[str], FieldMetadata(alias="addressId")] = pydantic.Field(
-        default=None
-    )
-    """
-    The ID of the geofence address of the idling location, if applicable. It will be the address at the time of idling.
-    """
-
-    address_type: typing_extensions.Annotated[
-        typing.Optional[IdlingEventObjectResponseBodyAddressType], FieldMetadata(alias="addressType")
-    ] = pydantic.Field(default=None)
-    """
-    The type of the geofence address of the idling location, if applicable.  Valid values: `agricultureSource`, `alertsOnly`, `avoidanceZone`, `industrialSite`, `knownGPSJammingZone`, `riskZone`, `shortHaul`, `undefined`, `workforceSite`, `yard`
-    """
-
+    address: typing.Optional[IdlingEventAddressObjectResponseBody] = None
     air_temperature_millicelsius: typing_extensions.Annotated[
         typing.Optional[int], FieldMetadata(alias="airTemperatureMillicelsius")
     ] = pydantic.Field(default=None)
@@ -37,11 +26,7 @@ class IdlingEventObjectResponseBody(UniversalBaseModel):
     The air temperature in millicelsius during the idling event. Value is returned only when it is known.
     """
 
-    asset_id: typing_extensions.Annotated[int, FieldMetadata(alias="assetId")] = pydantic.Field()
-    """
-    Samsara ID of the asset assigned to the event. Returns vehicle ID at this time.
-    """
-
+    asset: IdlingEventAssetObjectResponseBody
     duration_milliseconds: typing_extensions.Annotated[int, FieldMetadata(alias="durationMilliseconds")] = (
         pydantic.Field()
     )
@@ -72,13 +57,17 @@ class IdlingEventObjectResponseBody(UniversalBaseModel):
     gaseous_fuel_cost: typing_extensions.Annotated[
         GaseousFuelCostObjectResponseBody, FieldMetadata(alias="gaseousFuelCost")
     ]
-    operator_id: typing_extensions.Annotated[typing.Optional[int], FieldMetadata(alias="operatorId")] = pydantic.Field(
-        default=None
-    )
+    latitude: typing.Optional[float] = pydantic.Field(default=None)
+    """
+    The latitude of the location where the idling event occurred.
+    """
+
+    longitude: typing.Optional[float] = pydantic.Field(default=None)
     """
-    Samsara ID of the operator assigned the event. Returns driver ID at this time. Value is returned when the driver is assigned to the vehicle.
+    The longitude of the location where the idling event occurred.
     """
 
+    operator: typing.Optional[IdlingEventOperatorObjectResponseBody] = None
     pto_state: typing_extensions.Annotated[typing.Literal["active, inactive"], FieldMetadata(alias="ptoState")] = (
         pydantic.Field(default="active, inactive")
     )

samsara_api-4.2.0/src/samsara/types/idling_event_operator_object_response_body.py

@@ -0,0 +1,35 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+import pydantic
+import typing_extensions
+from ..core.pydantic_utilities import IS_PYDANTIC_V2, UniversalBaseModel
+from ..core.serialization import FieldMetadata
+
+
+class IdlingEventOperatorObjectResponseBody(UniversalBaseModel):
+    """
+    The operator associated with the idling event. Returns driver details at this time. Value is returned when a driver is assigned to the vehicle
+    """
+
+    external_ids: typing_extensions.Annotated[
+        typing.Optional[typing.Dict[str, str]], FieldMetadata(alias="externalIds")
+    ] = pydantic.Field(default=None)
+    """
+    A map of external ids for the operator.
+    """
+
+    id: int = pydantic.Field()
+    """
+    Samsara ID of the operator assigned to the event. Returns driver ID at this time.
+    """
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow

{samsara_api-4.1.0 → samsara_api-4.2.0}/src/samsara/work_orders/client.py

@@ -153,11 +153,14 @@ class WorkOrdersClient:
         discount: typing.Optional[WorkOrderDiscountObjectRequestBody] = OMIT,
         due_at_time: typing.Optional[dt.datetime] = OMIT,
         engine_hours: typing.Optional[int] = OMIT,
+        invoice_number: typing.Optional[str] = OMIT,
         items: typing.Optional[typing.Sequence[WorkOrderItemObjectRequestBody]] = OMIT,
         odometer_meters: typing.Optional[int] = OMIT,
+        po_number: typing.Optional[str] = OMIT,
         priority: typing.Optional[WorkOrdersPostWorkOrdersRequestBodyPriority] = OMIT,
         service_task_instances: typing.Optional[typing.Sequence[ServiceTaskInstanceInputObjectRequestBody]] = OMIT,
         tax: typing.Optional[WorkOrderTaxCreateObjectRequestBody] = OMIT,
+        vendor_uuid: typing.Optional[str] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> WorkOrdersPostWorkOrdersResponseBody:
         """
@@ -192,12 +195,18 @@ class WorkOrdersClient:
         engine_hours : typing.Optional[int]
             The engine hours at the time of the work order. Will default to current asset reading if unset.
 
+        invoice_number : typing.Optional[str]
+            The invoice number for the work order.
+
         items : typing.Optional[typing.Sequence[WorkOrderItemObjectRequestBody]]
             Items related to the work order.
 
         odometer_meters : typing.Optional[int]
             The odometer reading at the time of the work order. Will default to current asset reading if unset.
 
+        po_number : typing.Optional[str]
+            The purchase order number for the work order.
+
         priority : typing.Optional[WorkOrdersPostWorkOrdersRequestBodyPriority]
             The priority of the work order  Valid values: `High`, `Low`, `Medium`, `Urgent`
 
@@ -206,6 +215,9 @@ class WorkOrdersClient:
 
         tax : typing.Optional[WorkOrderTaxCreateObjectRequestBody]
 
+        vendor_uuid : typing.Optional[str]
+            The vendor UUID for the work order.
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -233,11 +245,14 @@ class WorkOrdersClient:
             discount=discount,
             due_at_time=due_at_time,
             engine_hours=engine_hours,
+            invoice_number=invoice_number,
             items=items,
             odometer_meters=odometer_meters,
+            po_number=po_number,
             priority=priority,
             service_task_instances=service_task_instances,
             tax=tax,
+            vendor_uuid=vendor_uuid,
             request_options=request_options,
         )
         return _response.data
@@ -629,11 +644,14 @@ class AsyncWorkOrdersClient:
         discount: typing.Optional[WorkOrderDiscountObjectRequestBody] = OMIT,
         due_at_time: typing.Optional[dt.datetime] = OMIT,
         engine_hours: typing.Optional[int] = OMIT,
+        invoice_number: typing.Optional[str] = OMIT,
         items: typing.Optional[typing.Sequence[WorkOrderItemObjectRequestBody]] = OMIT,
         odometer_meters: typing.Optional[int] = OMIT,
+        po_number: typing.Optional[str] = OMIT,
         priority: typing.Optional[WorkOrdersPostWorkOrdersRequestBodyPriority] = OMIT,
         service_task_instances: typing.Optional[typing.Sequence[ServiceTaskInstanceInputObjectRequestBody]] = OMIT,
         tax: typing.Optional[WorkOrderTaxCreateObjectRequestBody] = OMIT,
+        vendor_uuid: typing.Optional[str] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> WorkOrdersPostWorkOrdersResponseBody:
         """
@@ -668,12 +686,18 @@ class AsyncWorkOrdersClient:
         engine_hours : typing.Optional[int]
             The engine hours at the time of the work order. Will default to current asset reading if unset.
 
+        invoice_number : typing.Optional[str]
+            The invoice number for the work order.
+
         items : typing.Optional[typing.Sequence[WorkOrderItemObjectRequestBody]]
             Items related to the work order.
 
         odometer_meters : typing.Optional[int]
             The odometer reading at the time of the work order. Will default to current asset reading if unset.
 
+        po_number : typing.Optional[str]
+            The purchase order number for the work order.
+
         priority : typing.Optional[WorkOrdersPostWorkOrdersRequestBodyPriority]
             The priority of the work order  Valid values: `High`, `Low`, `Medium`, `Urgent`
 
@@ -682,6 +706,9 @@ class AsyncWorkOrdersClient:
 
         tax : typing.Optional[WorkOrderTaxCreateObjectRequestBody]
 
+        vendor_uuid : typing.Optional[str]
+            The vendor UUID for the work order.
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -717,11 +744,14 @@ class AsyncWorkOrdersClient:
             discount=discount,
             due_at_time=due_at_time,
             engine_hours=engine_hours,
+            invoice_number=invoice_number,
             items=items,
             odometer_meters=odometer_meters,
+            po_number=po_number,
             priority=priority,
             service_task_instances=service_task_instances,
             tax=tax,
+            vendor_uuid=vendor_uuid,
             request_options=request_options,
         )
         return _response.data