Fix the reload props response schema (#81)

* Fix the reload props response schema
* Add endpoint descriptions

---------

Co-authored-by: fern-api <115122769+fern-api[bot]@users.noreply.github.com>
Co-authored-by: Jay Vercellone <[email protected]>

Author: fern-api[bot]

src/pipedream/accounts/client.py

@@ -40,6 +40,8 @@ def list(
         request_options: typing.Optional[RequestOptions] = None,
     ) -> SyncPager[Account]:
         """
+        Retrieve all connected accounts for the project with optional filtering
+
         Parameters
         ----------
         app_id : typing.Optional[str]
@@ -111,6 +113,8 @@ def create(
         request_options: typing.Optional[RequestOptions] = None,
     ) -> Account:
         """
+        Connect a new account for an external user in the project
+
         Parameters
         ----------
         app_slug : str
@@ -177,6 +181,8 @@ def retrieve(
         request_options: typing.Optional[RequestOptions] = None,
     ) -> Account:
         """
+        Get the details for a specific connected account
+
         Parameters
         ----------
         account_id : str
@@ -213,6 +219,8 @@ def retrieve(
 
     def delete(self, account_id: str, *, request_options: typing.Optional[RequestOptions] = None) -> None:
         """
+        Remove a connected account and its associated credentials
+
         Parameters
         ----------
         account_id : str
@@ -243,6 +251,8 @@ def delete(self, account_id: str, *, request_options: typing.Optional[RequestOpt
 
     def delete_by_app(self, app_id: str, *, request_options: typing.Optional[RequestOptions] = None) -> None:
         """
+        Remove all connected accounts for a specific app
+
         Parameters
         ----------
         app_id : str
@@ -300,6 +310,8 @@ async def list(
         request_options: typing.Optional[RequestOptions] = None,
     ) -> AsyncPager[Account]:
         """
+        Retrieve all connected accounts for the project with optional filtering
+
         Parameters
         ----------
         app_id : typing.Optional[str]
@@ -380,6 +392,8 @@ async def create(
         request_options: typing.Optional[RequestOptions] = None,
     ) -> Account:
         """
+        Connect a new account for an external user in the project
+
         Parameters
         ----------
         app_slug : str
@@ -454,6 +468,8 @@ async def retrieve(
         request_options: typing.Optional[RequestOptions] = None,
     ) -> Account:
         """
+        Get the details for a specific connected account
+
         Parameters
         ----------
         account_id : str
@@ -498,6 +514,8 @@ async def main() -> None:
 
     async def delete(self, account_id: str, *, request_options: typing.Optional[RequestOptions] = None) -> None:
         """
+        Remove a connected account and its associated credentials
+
         Parameters
         ----------
         account_id : str
@@ -536,6 +554,8 @@ async def main() -> None:
 
     async def delete_by_app(self, app_id: str, *, request_options: typing.Optional[RequestOptions] = None) -> None:
         """
+        Remove all connected accounts for a specific app
+
         Parameters
         ----------
         app_id : str

src/pipedream/accounts/raw_client.py

@@ -34,6 +34,8 @@ def list(
         request_options: typing.Optional[RequestOptions] = None,
     ) -> SyncPager[Account]:
         """
+        Retrieve all connected accounts for the project with optional filtering
+
         Parameters
         ----------
         app_id : typing.Optional[str]
@@ -124,6 +126,8 @@ def create(
         request_options: typing.Optional[RequestOptions] = None,
     ) -> HttpResponse[Account]:
         """
+        Connect a new account for an external user in the project
+
         Parameters
         ----------
         app_slug : str
@@ -197,6 +201,8 @@ def retrieve(
         request_options: typing.Optional[RequestOptions] = None,
     ) -> HttpResponse[Account]:
         """
+        Get the details for a specific connected account
+
         Parameters
         ----------
         account_id : str
@@ -237,6 +243,8 @@ def retrieve(
 
     def delete(self, account_id: str, *, request_options: typing.Optional[RequestOptions] = None) -> HttpResponse[None]:
         """
+        Remove a connected account and its associated credentials
+
         Parameters
         ----------
         account_id : str
@@ -265,6 +273,8 @@ def delete_by_app(
         self, app_id: str, *, request_options: typing.Optional[RequestOptions] = None
     ) -> HttpResponse[None]:
         """
+        Remove all connected accounts for a specific app
+
         Parameters
         ----------
         app_id : str
@@ -307,6 +317,8 @@ async def list(
         request_options: typing.Optional[RequestOptions] = None,
     ) -> AsyncPager[Account]:
         """
+        Retrieve all connected accounts for the project with optional filtering
+
         Parameters
         ----------
         app_id : typing.Optional[str]
@@ -400,6 +412,8 @@ async def create(
         request_options: typing.Optional[RequestOptions] = None,
     ) -> AsyncHttpResponse[Account]:
         """
+        Connect a new account for an external user in the project
+
         Parameters
         ----------
         app_slug : str
@@ -473,6 +487,8 @@ async def retrieve(
         request_options: typing.Optional[RequestOptions] = None,
     ) -> AsyncHttpResponse[Account]:
         """
+        Get the details for a specific connected account
+
         Parameters
         ----------
         account_id : str
@@ -515,6 +531,8 @@ async def delete(
         self, account_id: str, *, request_options: typing.Optional[RequestOptions] = None
     ) -> AsyncHttpResponse[None]:
         """
+        Remove a connected account and its associated credentials
+
         Parameters
         ----------
         account_id : str
@@ -543,6 +561,8 @@ async def delete_by_app(
         self, app_id: str, *, request_options: typing.Optional[RequestOptions] = None
     ) -> AsyncHttpResponse[None]:
         """
+        Remove all connected accounts for a specific app
+
         Parameters
         ----------
         app_id : str

src/pipedream/actions/client.py

@@ -42,6 +42,8 @@ def list(
         request_options: typing.Optional[RequestOptions] = None,
     ) -> SyncPager[Component]:
         """
+        Retrieve available actions with optional search and app filtering
+
         Parameters
         ----------
         after : typing.Optional[str]
@@ -90,6 +92,8 @@ def list(
 
     def retrieve(self, component_id: str, *, request_options: typing.Optional[RequestOptions] = None) -> Component:
         """
+        Get detailed configuration for a specific action by its key
+
         Parameters
         ----------
         component_id : str
@@ -135,6 +139,8 @@ def configure_prop(
         request_options: typing.Optional[RequestOptions] = None,
     ) -> ConfigurePropResponse:
         """
+        Retrieve remote options for a given prop for a action
+
         Parameters
         ----------
         id : str
@@ -213,6 +219,8 @@ def reload_props(
         request_options: typing.Optional[RequestOptions] = None,
     ) -> ReloadPropsResponse:
         """
+        Reload the prop definition based on the currently configured props
+
         Parameters
         ----------
         id : str
@@ -274,6 +282,8 @@ def run(
         request_options: typing.Optional[RequestOptions] = None,
     ) -> RunActionResponse:
         """
+        Execute an action with the provided configuration and return results
+
         Parameters
         ----------
         id : str
@@ -350,6 +360,8 @@ async def list(
         request_options: typing.Optional[RequestOptions] = None,
     ) -> AsyncPager[Component]:
         """
+        Retrieve available actions with optional search and app filtering
+
         Parameters
         ----------
         after : typing.Optional[str]
@@ -409,6 +421,8 @@ async def retrieve(
         self, component_id: str, *, request_options: typing.Optional[RequestOptions] = None
     ) -> Component:
         """
+        Get detailed configuration for a specific action by its key
+
         Parameters
         ----------
         component_id : str
@@ -462,6 +476,8 @@ async def configure_prop(
         request_options: typing.Optional[RequestOptions] = None,
     ) -> ConfigurePropResponse:
         """
+        Retrieve remote options for a given prop for a action
+
         Parameters
         ----------
         id : str
@@ -548,6 +564,8 @@ async def reload_props(
         request_options: typing.Optional[RequestOptions] = None,
     ) -> ReloadPropsResponse:
         """
+        Reload the prop definition based on the currently configured props
+
         Parameters
         ----------
         id : str
@@ -617,6 +635,8 @@ async def run(
         request_options: typing.Optional[RequestOptions] = None,
     ) -> RunActionResponse:
         """
+        Execute an action with the provided configuration and return results
+
         Parameters
         ----------
         id : str

src/pipedream/actions/raw_client.py

@@ -38,6 +38,8 @@ def list(
         request_options: typing.Optional[RequestOptions] = None,
     ) -> SyncPager[Component]:
         """
+        Retrieve available actions with optional search and app filtering
+
         Parameters
         ----------
         after : typing.Optional[str]
@@ -110,6 +112,8 @@ def retrieve(
         self, component_id: str, *, request_options: typing.Optional[RequestOptions] = None
     ) -> HttpResponse[Component]:
         """
+        Get detailed configuration for a specific action by its key
+
         Parameters
         ----------
         component_id : str
@@ -159,6 +163,8 @@ def configure_prop(
         request_options: typing.Optional[RequestOptions] = None,
     ) -> HttpResponse[ConfigurePropResponse]:
         """
+        Retrieve remote options for a given prop for a action
+
         Parameters
         ----------
         id : str
@@ -242,6 +248,8 @@ def reload_props(
         request_options: typing.Optional[RequestOptions] = None,
     ) -> HttpResponse[ReloadPropsResponse]:
         """
+        Reload the prop definition based on the currently configured props
+
         Parameters
         ----------
         id : str
@@ -309,6 +317,8 @@ def run(
         request_options: typing.Optional[RequestOptions] = None,
     ) -> HttpResponse[RunActionResponse]:
         """
+        Execute an action with the provided configuration and return results
+
         Parameters
         ----------
         id : str
@@ -382,6 +392,8 @@ async def list(
         request_options: typing.Optional[RequestOptions] = None,
     ) -> AsyncPager[Component]:
         """
+        Retrieve available actions with optional search and app filtering
+
         Parameters
         ----------
         after : typing.Optional[str]
@@ -457,6 +469,8 @@ async def retrieve(
         self, component_id: str, *, request_options: typing.Optional[RequestOptions] = None
     ) -> AsyncHttpResponse[Component]:
         """
+        Get detailed configuration for a specific action by its key
+
         Parameters
         ----------
         component_id : str
@@ -506,6 +520,8 @@ async def configure_prop(
         request_options: typing.Optional[RequestOptions] = None,
     ) -> AsyncHttpResponse[ConfigurePropResponse]:
         """
+        Retrieve remote options for a given prop for a action
+
         Parameters
         ----------
         id : str
@@ -589,6 +605,8 @@ async def reload_props(
         request_options: typing.Optional[RequestOptions] = None,
     ) -> AsyncHttpResponse[ReloadPropsResponse]:
         """
+        Reload the prop definition based on the currently configured props
+
         Parameters
         ----------
         id : str
@@ -656,6 +674,8 @@ async def run(
         request_options: typing.Optional[RequestOptions] = None,
     ) -> AsyncHttpResponse[RunActionResponse]:
         """
+        Execute an action with the provided configuration and return results
+
         Parameters
         ----------
         id : str

src/pipedream/app_categories/client.py

@@ -26,6 +26,8 @@ def with_raw_response(self) -> RawAppCategoriesClient:
 
     def list(self, *, request_options: typing.Optional[RequestOptions] = None) -> ListAppCategoriesResponse:
         """
+        Retrieve all available categories for integrated apps
+
         Parameters
         ----------
         request_options : typing.Optional[RequestOptions]
@@ -53,6 +55,8 @@ def list(self, *, request_options: typing.Optional[RequestOptions] = None) -> Li
 
     def retrieve(self, id: str, *, request_options: typing.Optional[RequestOptions] = None) -> GetAppCategoryResponse:
         """
+        Get details of a specific app category by its ID
+
         Parameters
         ----------
         id : str
@@ -101,6 +105,8 @@ def with_raw_response(self) -> AsyncRawAppCategoriesClient:
 
     async def list(self, *, request_options: typing.Optional[RequestOptions] = None) -> ListAppCategoriesResponse:
         """
+        Retrieve all available categories for integrated apps
+
         Parameters
         ----------
         request_options : typing.Optional[RequestOptions]
@@ -138,6 +144,8 @@ async def retrieve(
         self, id: str, *, request_options: typing.Optional[RequestOptions] = None
     ) -> GetAppCategoryResponse:
         """
+        Get details of a specific app category by its ID
+
         Parameters
         ----------
         id : str