Accept "stash ID" when running actions (#52)

fern-api[bot] · jverce · web-flow · commit 1e4556ca6d4b · 2025-08-05T15:32:54.000-07:00
* Add the `stash_id` field to the "run action" opts
* Update dependencies
* Bump version

---------

Co-authored-by: fern-api &lt;115122769+fern-api[bot]@users.noreply.github.com&gt;
Co-authored-by: Jay Vercellone &lt;jverce@users.noreply.github.com&gt;
diff --git a/poetry.lock b/poetry.lock
diff --git a/pyproject.toml b/pyproject.toml
@@ -3,7 +3,7 @@ name = "pipedream"
 
 [tool.poetry]
 name = "pipedream"
-version = "1.0.2"
+version = "1.0.3"
 description = ""
 readme = "README.md"
 authors = []
diff --git a/src/pipedream/actions/__init__.py b/src/pipedream/actions/__init__.py
@@ -2,3 +2,6 @@
 
 # isort: skip_file
 
+from .types import RunActionOptsStashId
+
+__all__ = ["RunActionOptsStashId"]
diff --git a/src/pipedream/actions/client.py b/src/pipedream/actions/client.py
@@ -10,6 +10,7 @@
 from ..types.reload_props_response import ReloadPropsResponse
 from ..types.run_action_response import RunActionResponse
 from .raw_client import AsyncRawActionsClient, RawActionsClient
+from .types.run_action_opts_stash_id import RunActionOptsStashId
 
 # this is used as the default value for optional parameters
 OMIT = typing.cast(typing.Any, ...)
@@ -288,6 +289,7 @@ def run(
         async_handle: typing.Optional[str] = None,
         configured_props: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = OMIT,
         dynamic_props_id: typing.Optional[str] = OMIT,
+        stash_id: typing.Optional[RunActionOptsStashId] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> RunActionResponse:
         """
@@ -307,6 +309,9 @@ def run(
         dynamic_props_id : typing.Optional[str]
             The ID for dynamic props
 
+        stash_id : typing.Optional[RunActionOptsStashId]
+            The ID of the File Stash to use for syncing the action's /tmp directory
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -336,6 +341,7 @@ def run(
             async_handle=async_handle,
             configured_props=configured_props,
             dynamic_props_id=dynamic_props_id,
+            stash_id=stash_id,
             request_options=request_options,
         )
         return _response.data
@@ -649,6 +655,7 @@ async def run(
         async_handle: typing.Optional[str] = None,
         configured_props: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = OMIT,
         dynamic_props_id: typing.Optional[str] = OMIT,
+        stash_id: typing.Optional[RunActionOptsStashId] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> RunActionResponse:
         """
@@ -668,6 +675,9 @@ async def run(
         dynamic_props_id : typing.Optional[str]
             The ID for dynamic props
 
+        stash_id : typing.Optional[RunActionOptsStashId]
+            The ID of the File Stash to use for syncing the action's /tmp directory
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -705,6 +715,7 @@ async def main() -> None:
             async_handle=async_handle,
             configured_props=configured_props,
             dynamic_props_id=dynamic_props_id,
+            stash_id=stash_id,
             request_options=request_options,
         )
         return _response.data
diff --git a/src/pipedream/actions/raw_client.py b/src/pipedream/actions/raw_client.py
@@ -10,12 +10,14 @@
 from ..core.pagination import AsyncPager, BaseHttpResponse, SyncPager
 from ..core.pydantic_utilities import parse_obj_as
 from ..core.request_options import RequestOptions
+from ..core.serialization import convert_and_respect_annotation_metadata
 from ..types.component import Component
 from ..types.configure_prop_response import ConfigurePropResponse
 from ..types.get_component_response import GetComponentResponse
 from ..types.get_components_response import GetComponentsResponse
 from ..types.reload_props_response import ReloadPropsResponse
 from ..types.run_action_response import RunActionResponse
+from .types.run_action_opts_stash_id import RunActionOptsStashId
 
 # this is used as the default value for optional parameters
 OMIT = typing.cast(typing.Any, ...)
@@ -322,6 +324,7 @@ def run(
         async_handle: typing.Optional[str] = None,
         configured_props: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = OMIT,
         dynamic_props_id: typing.Optional[str] = OMIT,
+        stash_id: typing.Optional[RunActionOptsStashId] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> HttpResponse[RunActionResponse]:
         """
@@ -341,6 +344,9 @@ def run(
         dynamic_props_id : typing.Optional[str]
             The ID for dynamic props
 
+        stash_id : typing.Optional[RunActionOptsStashId]
+            The ID of the File Stash to use for syncing the action's /tmp directory
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -357,6 +363,9 @@ def run(
                 "external_user_id": external_user_id,
                 "configured_props": configured_props,
                 "dynamic_props_id": dynamic_props_id,
+                "stash_id": convert_and_respect_annotation_metadata(
+                    object_=stash_id, annotation=RunActionOptsStashId, direction="write"
+                ),
             },
             headers={
                 "content-type": "application/json",
@@ -685,6 +694,7 @@ async def run(
         async_handle: typing.Optional[str] = None,
         configured_props: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = OMIT,
         dynamic_props_id: typing.Optional[str] = OMIT,
+        stash_id: typing.Optional[RunActionOptsStashId] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> AsyncHttpResponse[RunActionResponse]:
         """
@@ -704,6 +714,9 @@ async def run(
         dynamic_props_id : typing.Optional[str]
             The ID for dynamic props
 
+        stash_id : typing.Optional[RunActionOptsStashId]
+            The ID of the File Stash to use for syncing the action's /tmp directory
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -720,6 +733,9 @@ async def run(
                 "external_user_id": external_user_id,
                 "configured_props": configured_props,
                 "dynamic_props_id": dynamic_props_id,
+                "stash_id": convert_and_respect_annotation_metadata(
+                    object_=stash_id, annotation=RunActionOptsStashId, direction="write"
+                ),
             },
             headers={
                 "content-type": "application/json",
diff --git a/src/pipedream/actions/types/__init__.py b/src/pipedream/actions/types/__init__.py
@@ -0,0 +1,7 @@
+# This file was auto-generated by Fern from our API Definition.
+
+# isort: skip_file
+
+from .run_action_opts_stash_id import RunActionOptsStashId
+
+__all__ = ["RunActionOptsStashId"]
diff --git a/src/pipedream/actions/types/run_action_opts_stash_id.py b/src/pipedream/actions/types/run_action_opts_stash_id.py
@@ -0,0 +1,5 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+RunActionOptsStashId = typing.Union[str, bool]
diff --git a/src/pipedream/core/client_wrapper.py b/src/pipedream/core/client_wrapper.py
@@ -27,10 +27,10 @@ def __init__(
 
     def get_headers(self) -> typing.Dict[str, str]:
         headers: typing.Dict[str, str] = {
-            "User-Agent": "pipedream/1.0.2",
+            "User-Agent": "pipedream/1.0.3",
             "X-Fern-Language": "Python",
             "X-Fern-SDK-Name": "pipedream",
-            "X-Fern-SDK-Version": "1.0.2",
+            "X-Fern-SDK-Version": "1.0.3",
             **(self.get_custom_headers() or {}),
         }
         if self._project_environment is not None:
