seam 2.139.0 → 2.141.0

data/lib/seam/routes/acs_entrances.rb

@@ -11,18 +11,18 @@ module Seam
       end
 
       # Returns a specified [access system entrance](https://docs.seam.co/low-level-apis/access-systems/retrieving-entrance-details).
-      # @param acs_entrance_id ID of the entrance that you want to get.
+      # @param acs_entrance_id [String] ID of the entrance that you want to get.
       # @return [Seam::Resources::AcsEntrance] OK
       def get(acs_entrance_id:)
-        res = @client.post("/acs/entrances/get", {acs_entrance_id: acs_entrance_id}.compact)
+        res = @client.get("/acs/entrances/get", {acs_entrance_id: acs_entrance_id}.compact)
 
         Seam::Resources::AcsEntrance.load_from_response(res.body["acs_entrance"])
       end
 
       # Grants a specified [access system user](https://docs.seam.co/low-level-apis/access-systems/user-management) access to a specified [access system entrance](https://docs.seam.co/low-level-apis/access-systems/retrieving-entrance-details).
-      # @param acs_entrance_id ID of the entrance to which you want to grant an access system user access.
-      # @param acs_user_id ID of the access system user to whom you want to grant access to an entrance. You can only provide one of acs_user_id or user_identity_id.
-      # @param user_identity_id ID of the user identity to whom you want to grant access to an entrance. You can only provide one of acs_user_id or user_identity_id. If the ACS system contains an ACS user with the same `email_address` or `phone_number` as the user identity that you specify, they are linked, and the access group membership belongs to the ACS user. If the ACS system does not have a corresponding ACS user, one is created.
+      # @param acs_entrance_id [String] ID of the entrance to which you want to grant an access system user access.
+      # @param acs_user_id [String, nil] ID of the access system user to whom you want to grant access to an entrance. You can only provide one of acs_user_id or user_identity_id.
+      # @param user_identity_id [String, nil] ID of the user identity to whom you want to grant access to an entrance. You can only provide one of acs_user_id or user_identity_id. If the ACS system contains an ACS user with the same `email_address` or `phone_number` as the user identity that you specify, they are linked, and the access group membership belongs to the ACS user. If the ACS system does not have a corresponding ACS user, one is created.
       # @return [nil] OK
       def grant_access(acs_entrance_id:, acs_user_id: nil, user_identity_id: nil)
         @client.post("/acs/entrances/grant_access", {acs_entrance_id: acs_entrance_id, acs_user_id: acs_user_id, user_identity_id: user_identity_id}.compact)
@@ -31,18 +31,18 @@ module Seam
       end
 
       # Returns a list of all [access system entrances](https://docs.seam.co/low-level-apis/access-systems/retrieving-entrance-details).
-      # @param access_method_id ID of the access method for which you want to retrieve all entrances to which it grants access.
-      # @param acs_credential_id ID of the credential for which you want to retrieve all entrances.
-      # @param acs_entrance_ids IDs of the entrances for which you want to retrieve all entrances.
-      # @param acs_system_id ID of the access system for which you want to retrieve all entrances.
-      # @param connected_account_id ID of the connected account for which you want to retrieve all entrances.
-      # @param customer_key Customer key for which you want to list entrances.
-      # @param limit Maximum number of records to return per page.
-      # @param location_id
+      # @param access_method_id [String, nil] ID of the access method for which you want to retrieve all entrances to which it grants access.
+      # @param acs_credential_id [String, nil] ID of the credential for which you want to retrieve all entrances.
+      # @param acs_entrance_ids [Array<String>, nil] IDs of the entrances for which you want to retrieve all entrances.
+      # @param acs_system_id [String, nil] ID of the access system for which you want to retrieve all entrances.
+      # @param connected_account_id [String, nil] ID of the connected account for which you want to retrieve all entrances.
+      # @param customer_key [String, nil] Customer key for which you want to list entrances.
+      # @param limit [Integer, nil] Maximum number of records to return per page.
+      # @param location_id [String, Seam::Null, nil]
       # @deprecated location_id: Use `space_id`.
-      # @param page_cursor Identifies the specific page of results to return, obtained from the previous page's `next_page_cursor`.
-      # @param search String for which to search. Filters returned entrances to include all records that satisfy a partial match using `display_name`.
-      # @param space_id ID of the space for which you want to list entrances.
+      # @param page_cursor [String, Seam::Null, nil] Identifies the specific page of results to return, obtained from the previous page's `next_page_cursor`.
+      # @param search [String, nil] String for which to search. Filters returned entrances to include all records that satisfy a partial match using `display_name`.
+      # @param space_id [String, nil] ID of the space for which you want to list entrances.
       # @return [Seam::Resources::AcsEntrance] OK
       def list(access_method_id: nil, acs_credential_id: nil, acs_entrance_ids: nil, acs_system_id: nil, connected_account_id: nil, customer_key: nil, limit: nil, location_id: nil, page_cursor: nil, search: nil, space_id: nil)
         res = @client.post("/acs/entrances/list", {access_method_id: access_method_id, acs_credential_id: acs_credential_id, acs_entrance_ids: acs_entrance_ids, acs_system_id: acs_system_id, connected_account_id: connected_account_id, customer_key: customer_key, limit: limit, location_id: location_id, page_cursor: page_cursor, search: search, space_id: space_id}.compact)
@@ -51,8 +51,8 @@ module Seam
       end
 
       # Returns a list of all [credentials](https://docs.seam.co/low-level-apis/access-systems/managing-credentials) with access to a specified [entrance](https://docs.seam.co/low-level-apis/access-systems/retrieving-entrance-details).
-      # @param acs_entrance_id ID of the entrance for which you want to list all credentials that grant access.
-      # @param include_if Conditions that credentials must meet to be included in the returned list.
+      # @param acs_entrance_id [String] ID of the entrance for which you want to list all credentials that grant access.
+      # @param include_if [Array<String>, nil] Conditions that credentials must meet to be included in the returned list.
       # @return [Seam::Resources::AcsCredential] OK
       def list_credentials_with_access(acs_entrance_id:, include_if: nil)
         res = @client.post("/acs/entrances/list_credentials_with_access", {acs_entrance_id: acs_entrance_id, include_if: include_if}.compact)
@@ -61,8 +61,8 @@ module Seam
       end
 
       # Remotely unlocks a specified [entrance](https://docs.seam.co/low-level-apis/access-systems/retrieving-entrance-details) using a cloud_key credential. Returns an action attempt that tracks the progress of the unlock operation.
-      # @param acs_credential_id ID of the cloud_key credential to use for the unlock operation.
-      # @param acs_entrance_id ID of the entrance to unlock.
+      # @param acs_credential_id [String] ID of the cloud_key credential to use for the unlock operation.
+      # @param acs_entrance_id [String] ID of the entrance to unlock.
       # @return [Seam::Resources::ActionAttempt] OK
       def unlock(acs_credential_id:, acs_entrance_id:, wait_for_action_attempt: nil)
         res = @client.post("/acs/entrances/unlock", {acs_credential_id: acs_credential_id, acs_entrance_id: acs_entrance_id}.compact)

data/lib/seam/routes/acs_systems.rb

@@ -9,10 +9,10 @@ module Seam
       end
 
       # Returns a specified [access system](https://docs.seam.co/low-level-apis/access-systems).
-      # @param acs_system_id ID of the access system that you want to get.
+      # @param acs_system_id [String] ID of the access system that you want to get.
       # @return [Seam::Resources::AcsSystem] OK
       def get(acs_system_id:)
-        res = @client.post("/acs/systems/get", {acs_system_id: acs_system_id}.compact)
+        res = @client.get("/acs/systems/get", {acs_system_id: acs_system_id}.compact)
 
         Seam::Resources::AcsSystem.load_from_response(res.body["acs_system"])
       end
@@ -20,12 +20,12 @@ module Seam
       # Returns a list of all [access systems](https://docs.seam.co/low-level-apis/access-systems).
       #
       # To filter the list of returned access systems by a specific connected account ID, include the `connected_account_id` in the request body. If you omit the `connected_account_id` parameter, the response includes all access systems connected to your workspace.
-      # @param connected_account_id ID of the connected account by which you want to filter the list of access systems.
-      # @param customer_key Customer key for which you want to list access systems.
-      # @param search String for which to search. Filters returned access systems to include all records that satisfy a partial match using `name` or `acs_system_id`.
+      # @param connected_account_id [String, nil] ID of the connected account by which you want to filter the list of access systems.
+      # @param customer_key [String, nil] Customer key for which you want to list access systems.
+      # @param search [String, nil] String for which to search. Filters returned access systems to include all records that satisfy a partial match using `name` or `acs_system_id`.
       # @return [Seam::Resources::AcsSystem] OK
       def list(connected_account_id: nil, customer_key: nil, search: nil)
-        res = @client.post("/acs/systems/list", {connected_account_id: connected_account_id, customer_key: customer_key, search: search}.compact)
+        res = @client.get("/acs/systems/list", {connected_account_id: connected_account_id, customer_key: customer_key, search: search}.compact)
 
         Seam::Resources::AcsSystem.load_from_response(res.body["acs_systems"])
       end
@@ -33,18 +33,18 @@ module Seam
       # Returns a list of all credential manager systems that are compatible with a specified [access system](https://docs.seam.co/low-level-apis/access-systems).
       #
       # Specify the access system for which you want to retrieve all compatible credential manager systems by including the corresponding `acs_system_id` in the request body.
-      # @param acs_system_id ID of the access system for which you want to retrieve all compatible credential manager systems.
+      # @param acs_system_id [String] ID of the access system for which you want to retrieve all compatible credential manager systems.
       # @return [Seam::Resources::AcsSystem] OK
       def list_compatible_credential_manager_acs_systems(acs_system_id:)
-        res = @client.post("/acs/systems/list_compatible_credential_manager_acs_systems", {acs_system_id: acs_system_id}.compact)
+        res = @client.get("/acs/systems/list_compatible_credential_manager_acs_systems", {acs_system_id: acs_system_id}.compact)
 
         Seam::Resources::AcsSystem.load_from_response(res.body["acs_systems"])
       end
 
       # Reports ACS system device status including encoders and entrances.
-      # @param acs_system_id ID of the ACS system to report resources for
-      # @param acs_encoders Array of ACS encoders to report
-      # @param acs_entrances Array of ACS entrances to report
+      # @param acs_system_id [String] ID of the ACS system to report resources for
+      # @param acs_encoders [Array<Hash>, nil] Array of ACS encoders to report
+      # @param acs_entrances [Array<Hash>, nil] Array of ACS entrances to report
       # @return [nil] OK
       def report_devices(acs_system_id:, acs_encoders: nil, acs_entrances: nil)
         @client.post("/acs/systems/report_devices", {acs_system_id: acs_system_id, acs_encoders: acs_encoders, acs_entrances: acs_entrances}.compact)

data/lib/seam/routes/acs_users.rb

@@ -9,25 +9,25 @@ module Seam
       end
 
       # Adds a specified [access system user](https://docs.seam.co/low-level-apis/access-systems/user-management) to a specified [access group](https://docs.seam.co/low-level-apis/access-systems/user-management/assigning-users-to-access-groups).
-      # @param acs_access_group_id ID of the access group to which you want to add an access system user.
-      # @param acs_user_id ID of the access system user that you want to add to an access group.
+      # @param acs_access_group_id [String] ID of the access group to which you want to add an access system user.
+      # @param acs_user_id [String] ID of the access system user that you want to add to an access group.
       # @return [nil] OK
       def add_to_access_group(acs_access_group_id:, acs_user_id:)
-        @client.post("/acs/users/add_to_access_group", {acs_access_group_id: acs_access_group_id, acs_user_id: acs_user_id}.compact)
+        @client.put("/acs/users/add_to_access_group", {acs_access_group_id: acs_access_group_id, acs_user_id: acs_user_id}.compact)
 
         nil
       end
 
       # Creates a new [access system user](https://docs.seam.co/low-level-apis/access-systems/user-management).
-      # @param acs_system_id ID of the access system to which you want to add the new access system user.
-      # @param full_name Full name of the new access system user.
-      # @param access_schedule `starts_at` and `ends_at` timestamps for the new access system user's access. If you specify an `access_schedule`, you may include both `starts_at` and `ends_at`. If you omit `starts_at`, it defaults to the current time. `ends_at` is optional and must be a time in the future and after `starts_at`.
-      # @param acs_access_group_ids Array of access group IDs to indicate the access groups to which you want to add the new access system user.
-      # @param email
+      # @param acs_system_id [String] ID of the access system to which you want to add the new access system user.
+      # @param full_name [String] Full name of the new access system user.
+      # @param access_schedule [Hash, nil] `starts_at` and `ends_at` timestamps for the new access system user's access. If you specify an `access_schedule`, you may include both `starts_at` and `ends_at`. If you omit `starts_at`, it defaults to the current time. `ends_at` is optional and must be a time in the future and after `starts_at`.
+      # @param acs_access_group_ids [Array<String>, nil] Array of access group IDs to indicate the access groups to which you want to add the new access system user.
+      # @param email [String, nil]
       # @deprecated email: use email_address.
-      # @param email_address Email address of the [access system user](https://docs.seam.co/low-level-apis/access-systems/user-management).
-      # @param phone_number Phone number of the [access system user](https://docs.seam.co/low-level-apis/access-systems/user-management) in E.164 format (for example, `+15555550100`).
-      # @param user_identity_id ID of the user identity with which you want to associate the new access system user.
+      # @param email_address [String, nil] Email address of the [access system user](https://docs.seam.co/low-level-apis/access-systems/user-management).
+      # @param phone_number [String, nil] Phone number of the [access system user](https://docs.seam.co/low-level-apis/access-systems/user-management) in E.164 format (for example, `+15555550100`).
+      # @param user_identity_id [String, nil] ID of the user identity with which you want to associate the new access system user.
       # @return [Seam::Resources::AcsUser] OK
       def create(acs_system_id:, full_name:, access_schedule: nil, acs_access_group_ids: nil, email: nil, email_address: nil, phone_number: nil, user_identity_id: nil)
         res = @client.post("/acs/users/create", {acs_system_id: acs_system_id, full_name: full_name, access_schedule: access_schedule, acs_access_group_ids: acs_access_group_ids, email: email, email_address: email_address, phone_number: phone_number, user_identity_id: user_identity_id}.compact)
@@ -36,112 +36,140 @@ module Seam
       end
 
       # Deletes a specified [access system user](https://docs.seam.co/low-level-apis/access-systems/user-management) and invalidates the access system user's [credentials](https://docs.seam.co/low-level-apis/access-systems/managing-credentials).
-      # @param acs_system_id ID of the access system that you want to delete. You must provide acs_system_id with user_identity_id.
-      # @param acs_user_id ID of the access system user that you want to delete. You must provide either acs_user_id or user_identity_id
-      # @param user_identity_id ID of the user identity that you want to delete. You must provide either acs_user_id or user_identity_id. If you provide user_identity_id, you must also provide acs_system_id.
+      # @param acs_system_id [String, nil] ID of the access system that you want to delete. You must provide acs_system_id with user_identity_id.
+      # @param acs_user_id [String, nil] ID of the access system user that you want to delete. You must provide either acs_user_id or user_identity_id
+      # @param user_identity_id [String, nil] ID of the user identity that you want to delete. You must provide either acs_user_id or user_identity_id. If you provide user_identity_id, you must also provide acs_system_id.
       # @return [nil] OK
       def delete(acs_system_id: nil, acs_user_id: nil, user_identity_id: nil)
-        @client.post("/acs/users/delete", {acs_system_id: acs_system_id, acs_user_id: acs_user_id, user_identity_id: user_identity_id}.compact)
+        if acs_system_id.nil? && acs_user_id.nil? && user_identity_id.nil?
+          raise TypeError, "At least one parameter is required for /acs/users/delete"
+        end
+
+        @client.delete("/acs/users/delete", {acs_system_id: acs_system_id, acs_user_id: acs_user_id, user_identity_id: user_identity_id}.compact)
 
         nil
       end
 
       # Returns a specified [access system user](https://docs.seam.co/low-level-apis/access-systems/user-management).
-      # @param acs_user_id ID of the access system user that you want to get. You can only provide acs_user_id or user_identity_id.
-      # @param acs_system_id ID of the access system that you want to get. You can only provide acs_user_id or user_identity_id.
-      # @param user_identity_id ID of the user identity that you want to get. You can only provide acs_user_id or user_identity_id.
+      # @param acs_user_id [String, nil] ID of the access system user that you want to get. You can only provide acs_user_id or user_identity_id.
+      # @param acs_system_id [String, nil] ID of the access system that you want to get. You can only provide acs_user_id or user_identity_id.
+      # @param user_identity_id [String, nil] ID of the user identity that you want to get. You can only provide acs_user_id or user_identity_id.
       # @return [Seam::Resources::AcsUser] OK
       def get(acs_user_id: nil, acs_system_id: nil, user_identity_id: nil)
-        res = @client.post("/acs/users/get", {acs_user_id: acs_user_id, acs_system_id: acs_system_id, user_identity_id: user_identity_id}.compact)
+        if acs_user_id.nil? && acs_system_id.nil? && user_identity_id.nil?
+          raise TypeError, "At least one parameter is required for /acs/users/get"
+        end
+
+        res = @client.get("/acs/users/get", {acs_user_id: acs_user_id, acs_system_id: acs_system_id, user_identity_id: user_identity_id}.compact)
 
         Seam::Resources::AcsUser.load_from_response(res.body["acs_user"])
       end
 
       # Returns a list of all [access system users](https://docs.seam.co/low-level-apis/access-systems/user-management).
-      # @param acs_system_id ID of the `acs_system` for which you want to retrieve all access system users.
-      # @param created_before Timestamp by which to limit returned access system users. Returns users created before this timestamp.
-      # @param limit Maximum number of records to return per page.
-      # @param page_cursor Identifies the specific page of results to return, obtained from the previous page's `next_page_cursor`.
-      # @param search String for which to search. Filters returned access system users to include all records that satisfy a partial match using `full_name`, `phone_number`, `email_address`, `acs_user_id`, `user_identity_id`, `user_identity_full_name` or `user_identity_phone_number`.
-      # @param user_identity_email_address Email address of the user identity for which you want to retrieve all access system users.
-      # @param user_identity_id ID of the user identity for which you want to retrieve all access system users.
-      # @param user_identity_phone_number Phone number of the user identity for which you want to retrieve all access system users, in [E.164 format](https://www.itu.int/rec/T-REC-E.164/en) (for example, `+15555550100`).
+      # @param acs_system_id [String, nil] ID of the `acs_system` for which you want to retrieve all access system users.
+      # @param created_before [Time, nil] Timestamp by which to limit returned access system users. Returns users created before this timestamp.
+      # @param limit [Integer, nil] Maximum number of records to return per page.
+      # @param page_cursor [String, Seam::Null, nil] Identifies the specific page of results to return, obtained from the previous page's `next_page_cursor`.
+      # @param search [String, nil] String for which to search. Filters returned access system users to include all records that satisfy a partial match using `full_name`, `phone_number`, `email_address`, `acs_user_id`, `user_identity_id`, `user_identity_full_name` or `user_identity_phone_number`.
+      # @param user_identity_email_address [String, nil] Email address of the user identity for which you want to retrieve all access system users.
+      # @param user_identity_id [String, nil] ID of the user identity for which you want to retrieve all access system users.
+      # @param user_identity_phone_number [String, nil] Phone number of the user identity for which you want to retrieve all access system users, in [E.164 format](https://www.itu.int/rec/T-REC-E.164/en) (for example, `+15555550100`).
       # @return [Seam::Resources::AcsUser] OK
       def list(acs_system_id: nil, created_before: nil, limit: nil, page_cursor: nil, search: nil, user_identity_email_address: nil, user_identity_id: nil, user_identity_phone_number: nil)
-        res = @client.post("/acs/users/list", {acs_system_id: acs_system_id, created_before: created_before, limit: limit, page_cursor: page_cursor, search: search, user_identity_email_address: user_identity_email_address, user_identity_id: user_identity_id, user_identity_phone_number: user_identity_phone_number}.compact)
+        res = @client.get("/acs/users/list", {acs_system_id: acs_system_id, created_before: created_before, limit: limit, page_cursor: page_cursor, search: search, user_identity_email_address: user_identity_email_address, user_identity_id: user_identity_id, user_identity_phone_number: user_identity_phone_number}.compact)
 
         Seam::Resources::AcsUser.load_from_response(res.body["acs_users"])
       end
 
       # Lists the [entrances](https://docs.seam.co/api/acs/entrances) to which a specified [access system user](https://docs.seam.co/low-level-apis/access-systems/user-management) has access.
-      # @param acs_system_id ID of the access system for which you want to list accessible entrances. You can only provide acs_system_id with user_identity_id.
-      # @param acs_user_id ID of the access system user for whom you want to list accessible entrances. You can only provide acs_user_id or user_identity_id.
-      # @param user_identity_id ID of the user identity for whom you want to list accessible entrances. You can only provide acs_user_id or user_identity_id.
+      # @param acs_system_id [String, nil] ID of the access system for which you want to list accessible entrances. You can only provide acs_system_id with user_identity_id.
+      # @param acs_user_id [String, nil] ID of the access system user for whom you want to list accessible entrances. You can only provide acs_user_id or user_identity_id.
+      # @param user_identity_id [String, nil] ID of the user identity for whom you want to list accessible entrances. You can only provide acs_user_id or user_identity_id.
       # @return [Seam::Resources::AcsEntrance] OK
       def list_accessible_entrances(acs_system_id: nil, acs_user_id: nil, user_identity_id: nil)
-        res = @client.post("/acs/users/list_accessible_entrances", {acs_system_id: acs_system_id, acs_user_id: acs_user_id, user_identity_id: user_identity_id}.compact)
+        if acs_system_id.nil? && acs_user_id.nil? && user_identity_id.nil?
+          raise TypeError, "At least one parameter is required for /acs/users/list_accessible_entrances"
+        end
+
+        res = @client.get("/acs/users/list_accessible_entrances", {acs_system_id: acs_system_id, acs_user_id: acs_user_id, user_identity_id: user_identity_id}.compact)
 
         Seam::Resources::AcsEntrance.load_from_response(res.body["acs_entrances"])
       end
 
       # Removes a specified [access system user](https://docs.seam.co/low-level-apis/access-systems/user-management) from a specified [access group](https://docs.seam.co/low-level-apis/access-systems/user-management/assigning-users-to-access-groups).
-      # @param acs_access_group_id ID of the access group from which you want to remove an access system user.
-      # @param acs_user_id ID of the access system user that you want to remove from an access group. You can only provide acs_user_id or user_identity_id.
-      # @param user_identity_id ID of the user identity that you want to remove from an access group. You can only provide acs_user_id or user_identity_id.
+      # @param acs_access_group_id [String] ID of the access group from which you want to remove an access system user.
+      # @param acs_user_id [String, nil] ID of the access system user that you want to remove from an access group. You can only provide acs_user_id or user_identity_id.
+      # @param user_identity_id [String, nil] ID of the user identity that you want to remove from an access group. You can only provide acs_user_id or user_identity_id.
       # @return [nil] OK
       def remove_from_access_group(acs_access_group_id:, acs_user_id: nil, user_identity_id: nil)
-        @client.post("/acs/users/remove_from_access_group", {acs_access_group_id: acs_access_group_id, acs_user_id: acs_user_id, user_identity_id: user_identity_id}.compact)
+        @client.delete("/acs/users/remove_from_access_group", {acs_access_group_id: acs_access_group_id, acs_user_id: acs_user_id, user_identity_id: user_identity_id}.compact)
 
         nil
       end
 
       # Revokes access to all [entrances](https://docs.seam.co/api/acs/entrances) for a specified [access system user](https://docs.seam.co/low-level-apis/access-systems/user-management).
-      # @param acs_system_id ID of the access system for which you want to revoke access. You can only provide acs_system_id with user_identity_id.
-      # @param acs_user_id ID of the access system user for whom you want to revoke access. You can only provide acs_user_id or user_identity_id.
-      # @param user_identity_id ID of the user identity for whom you want to revoke access. You can only provide acs_user_id or user_identity_id.
+      # @param acs_system_id [String, nil] ID of the access system for which you want to revoke access. You can only provide acs_system_id with user_identity_id.
+      # @param acs_user_id [String, nil] ID of the access system user for whom you want to revoke access. You can only provide acs_user_id or user_identity_id.
+      # @param user_identity_id [String, nil] ID of the user identity for whom you want to revoke access. You can only provide acs_user_id or user_identity_id.
       # @return [nil] OK
       def revoke_access_to_all_entrances(acs_system_id: nil, acs_user_id: nil, user_identity_id: nil)
+        if acs_system_id.nil? && acs_user_id.nil? && user_identity_id.nil?
+          raise TypeError, "At least one parameter is required for /acs/users/revoke_access_to_all_entrances"
+        end
+
         @client.post("/acs/users/revoke_access_to_all_entrances", {acs_system_id: acs_system_id, acs_user_id: acs_user_id, user_identity_id: user_identity_id}.compact)
 
         nil
       end
 
       # [Suspends](https://docs.seam.co/low-level-apis/access-systems/user-management/suspending-and-unsuspending-users#suspend-an-acs-user) a specified [access system user](https://docs.seam.co/low-level-apis/access-systems/user-management). Suspending an access system user revokes their access temporarily. To restore an access system user's access, you can [unsuspend](https://docs.seam.co/api/acs/users/unsuspend) them.
-      # @param acs_system_id ID of the access system that you want to suspend. You can only provide acs_user_id or the combination of acs_system_id and user_identity_id.
-      # @param acs_user_id ID of the access system user that you want to suspend. You can only provide acs_user_id or the combination of acs_system_id and user_identity_id.
-      # @param user_identity_id ID of the user identity that you want to suspend. You can only provide acs_user_id or the combination of acs_system_id and user_identity_id.
+      # @param acs_system_id [String, nil] ID of the access system that you want to suspend. You can only provide acs_user_id or the combination of acs_system_id and user_identity_id.
+      # @param acs_user_id [String, nil] ID of the access system user that you want to suspend. You can only provide acs_user_id or the combination of acs_system_id and user_identity_id.
+      # @param user_identity_id [String, nil] ID of the user identity that you want to suspend. You can only provide acs_user_id or the combination of acs_system_id and user_identity_id.
       # @return [nil] OK
       def suspend(acs_system_id: nil, acs_user_id: nil, user_identity_id: nil)
+        if acs_system_id.nil? && acs_user_id.nil? && user_identity_id.nil?
+          raise TypeError, "At least one parameter is required for /acs/users/suspend"
+        end
+
         @client.post("/acs/users/suspend", {acs_system_id: acs_system_id, acs_user_id: acs_user_id, user_identity_id: user_identity_id}.compact)
 
         nil
       end
 
       # [Unsuspends](https://docs.seam.co/low-level-apis/access-systems/user-management/suspending-and-unsuspending-users#unsuspend-an-acs-user) a specified suspended [access system user](https://docs.seam.co/low-level-apis/access-systems/user-management). While [suspending an access system user](https://docs.seam.co/api/acs/users/suspend) revokes their access temporarily, unsuspending the access system user restores their access.
-      # @param acs_system_id ID of the access system of the user that you want to unsuspend. You can only provide acs_system_id with user_identity_id.
-      # @param acs_user_id ID of the access system user that you want to unsuspend. You can only provide acs_user_id or the combination of acs_system_id and user_identity_id.
-      # @param user_identity_id ID of the user identity that you want to unsuspend. You can only provide acs_user_id or the combination of acs_system_id and user_identity_id.
+      # @param acs_system_id [String, nil] ID of the access system of the user that you want to unsuspend. You can only provide acs_system_id with user_identity_id.
+      # @param acs_user_id [String, nil] ID of the access system user that you want to unsuspend. You can only provide acs_user_id or the combination of acs_system_id and user_identity_id.
+      # @param user_identity_id [String, nil] ID of the user identity that you want to unsuspend. You can only provide acs_user_id or the combination of acs_system_id and user_identity_id.
       # @return [nil] OK
       def unsuspend(acs_system_id: nil, acs_user_id: nil, user_identity_id: nil)
+        if acs_system_id.nil? && acs_user_id.nil? && user_identity_id.nil?
+          raise TypeError, "At least one parameter is required for /acs/users/unsuspend"
+        end
+
         @client.post("/acs/users/unsuspend", {acs_system_id: acs_system_id, acs_user_id: acs_user_id, user_identity_id: user_identity_id}.compact)
 
         nil
       end
 
       # Updates the properties of a specified [access system user](https://docs.seam.co/low-level-apis/access-systems/user-management).
-      # @param access_schedule `starts_at` and `ends_at` timestamps for the access system user's access. If you specify an `access_schedule`, you may include both `starts_at` and `ends_at`. If you omit `starts_at`, it defaults to the current time. `ends_at` is optional and must be a time in the future and after `starts_at`.
-      # @param acs_system_id ID of the access system that you want to update. You can only provide acs_system_id with user_identity_id.
-      # @param acs_user_id ID of the access system user that you want to update. You can only provide acs_user_id or user_identity_id.
-      # @param email
+      # @param access_schedule [Hash, Seam::Null, nil] `starts_at` and `ends_at` timestamps for the access system user's access. If you specify an `access_schedule`, you may include both `starts_at` and `ends_at`. If you omit `starts_at`, it defaults to the current time. `ends_at` is optional and must be a time in the future and after `starts_at`.
+      # @param acs_system_id [String, nil] ID of the access system that you want to update. You can only provide acs_system_id with user_identity_id.
+      # @param acs_user_id [String, nil] ID of the access system user that you want to update. You can only provide acs_user_id or user_identity_id.
+      # @param email [String, nil]
       # @deprecated email: use email_address.
-      # @param email_address Email address of the [access system user](https://docs.seam.co/low-level-apis/access-systems/user-management).
-      # @param full_name Full name of the [access system user](https://docs.seam.co/low-level-apis/access-systems/user-management).
-      # @param hid_acs_system_id ID of the HID access control system associated with the user.
-      # @param phone_number Phone number of the [access system user](https://docs.seam.co/low-level-apis/access-systems/user-management) in E.164 format (for example, `+15555550100`).
-      # @param user_identity_id ID of the user identity that you want to update. You can only provide acs_user_id or user_identity_id. If you provide user_identity_id, you must also provide acs_system_id.
+      # @param email_address [String, nil] Email address of the [access system user](https://docs.seam.co/low-level-apis/access-systems/user-management).
+      # @param full_name [String, nil] Full name of the [access system user](https://docs.seam.co/low-level-apis/access-systems/user-management).
+      # @param hid_acs_system_id [String, nil] ID of the HID access control system associated with the user.
+      # @param phone_number [String, nil] Phone number of the [access system user](https://docs.seam.co/low-level-apis/access-systems/user-management) in E.164 format (for example, `+15555550100`).
+      # @param user_identity_id [String, nil] ID of the user identity that you want to update. You can only provide acs_user_id or user_identity_id. If you provide user_identity_id, you must also provide acs_system_id.
       # @return [nil] OK
       def update(access_schedule: nil, acs_system_id: nil, acs_user_id: nil, email: nil, email_address: nil, full_name: nil, hid_acs_system_id: nil, phone_number: nil, user_identity_id: nil)
-        @client.post("/acs/users/update", {access_schedule: access_schedule, acs_system_id: acs_system_id, acs_user_id: acs_user_id, email: email, email_address: email_address, full_name: full_name, hid_acs_system_id: hid_acs_system_id, phone_number: phone_number, user_identity_id: user_identity_id}.compact)
+        if access_schedule.nil? && acs_system_id.nil? && acs_user_id.nil? && email.nil? && email_address.nil? && full_name.nil? && hid_acs_system_id.nil? && phone_number.nil? && user_identity_id.nil?
+          raise TypeError, "At least one parameter is required for /acs/users/update"
+        end
+
+        @client.patch("/acs/users/update", {access_schedule: access_schedule, acs_system_id: acs_system_id, acs_user_id: acs_user_id, email: email, email_address: email_address, full_name: full_name, hid_acs_system_id: hid_acs_system_id, phone_number: phone_number, user_identity_id: user_identity_id}.compact)
 
         nil
       end

data/lib/seam/routes/action_attempts.rb

@@ -11,10 +11,10 @@ module Seam
       end
 
       # Returns a specified [action attempt](https://docs.seam.co/core-concepts/action-attempts).
-      # @param action_attempt_id ID of the action attempt that you want to get.
+      # @param action_attempt_id [String] ID of the action attempt that you want to get.
       # @return [Seam::Resources::ActionAttempt] OK
       def get(action_attempt_id:, wait_for_action_attempt: nil)
-        res = @client.post("/action_attempts/get", {action_attempt_id: action_attempt_id}.compact)
+        res = @client.get("/action_attempts/get", {action_attempt_id: action_attempt_id}.compact)
 
         wait_for_action_attempt = wait_for_action_attempt.nil? ? @defaults.wait_for_action_attempt : wait_for_action_attempt
 
@@ -22,10 +22,10 @@ module Seam
       end
 
       # Returns a list of the [action attempts](https://docs.seam.co/core-concepts/action-attempts) that you specify as an array of `action_attempt_id`s.
-      # @param action_attempt_ids IDs of the action attempts that you want to retrieve.
-      # @param device_id ID of the device to filter action attempts by.
-      # @param limit Maximum number of records to return per page.
-      # @param page_cursor Identifies the specific page of results to return, obtained from the previous page's `next_page_cursor`.
+      # @param action_attempt_ids [Array<String>, nil] IDs of the action attempts that you want to retrieve.
+      # @param device_id [String, nil] ID of the device to filter action attempts by.
+      # @param limit [Integer, nil] Maximum number of records to return per page.
+      # @param page_cursor [String, Seam::Null, nil] Identifies the specific page of results to return, obtained from the previous page's `next_page_cursor`.
       # @return [Seam::Resources::ActionAttempt] OK
       def list(action_attempt_ids: nil, device_id: nil, limit: nil, page_cursor: nil)
         res = @client.post("/action_attempts/list", {action_attempt_ids: action_attempt_ids, device_id: device_id, limit: limit, page_cursor: page_cursor}.compact)

data/lib/seam/routes/client_sessions.rb

@@ -9,48 +9,48 @@ module Seam
       end
 
       # Creates a new [client session](https://docs.seam.co/core-concepts/authentication/client-session-tokens).
-      # @param connect_webview_ids IDs of the [Connect Webviews](https://docs.seam.co/core-concepts/connect-webviews) for which you want to create a client session.
-      # @param connected_account_ids IDs of the [connected accounts](https://docs.seam.co/core-concepts/connected-accounts) for which you want to create a client session.
-      # @param customer_id Customer ID that you want to associate with the new client session.
-      # @param customer_key Customer key that you want to associate with the new client session.
-      # @param expires_at Date and time at which the client session should expire, in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format.
-      # @param user_identifier_key Your user ID for the user for whom you want to create a client session.
-      # @param user_identity_id ID of the [user identity](https://docs.seam.co/capability-guides/mobile-access/managing-mobile-app-user-accounts-with-user-identities#what-is-a-user-identity) for which you want to create a client session.
-      # @param user_identity_ids IDs of the [user identities](https://docs.seam.co/capability-guides/mobile-access/managing-mobile-app-user-accounts-with-user-identities#what-is-a-user-identity) that you want to associate with the client session.
+      # @param connect_webview_ids [Array<String>, nil] IDs of the [Connect Webviews](https://docs.seam.co/core-concepts/connect-webviews) for which you want to create a client session.
+      # @param connected_account_ids [Array<String>, nil] IDs of the [connected accounts](https://docs.seam.co/core-concepts/connected-accounts) for which you want to create a client session.
+      # @param customer_id [String, nil] Customer ID that you want to associate with the new client session.
+      # @param customer_key [String, nil] Customer key that you want to associate with the new client session.
+      # @param expires_at [Time, nil] Date and time at which the client session should expire, in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format.
+      # @param user_identifier_key [String, nil] Your user ID for the user for whom you want to create a client session.
+      # @param user_identity_id [String, nil] ID of the [user identity](https://docs.seam.co/capability-guides/mobile-access/managing-mobile-app-user-accounts-with-user-identities#what-is-a-user-identity) for which you want to create a client session.
+      # @param user_identity_ids [Array<String>, nil] IDs of the [user identities](https://docs.seam.co/capability-guides/mobile-access/managing-mobile-app-user-accounts-with-user-identities#what-is-a-user-identity) that you want to associate with the client session.
       # @deprecated user_identity_ids: Use `user_identity_id` instead.
       # @return [Seam::Resources::ClientSession] OK
       def create(connect_webview_ids: nil, connected_account_ids: nil, customer_id: nil, customer_key: nil, expires_at: nil, user_identifier_key: nil, user_identity_id: nil, user_identity_ids: nil)
-        res = @client.post("/client_sessions/create", {connect_webview_ids: connect_webview_ids, connected_account_ids: connected_account_ids, customer_id: customer_id, customer_key: customer_key, expires_at: expires_at, user_identifier_key: user_identifier_key, user_identity_id: user_identity_id, user_identity_ids: user_identity_ids}.compact)
+        res = @client.put("/client_sessions/create", {connect_webview_ids: connect_webview_ids, connected_account_ids: connected_account_ids, customer_id: customer_id, customer_key: customer_key, expires_at: expires_at, user_identifier_key: user_identifier_key, user_identity_id: user_identity_id, user_identity_ids: user_identity_ids}.compact)
 
         Seam::Resources::ClientSession.load_from_response(res.body["client_session"])
       end
 
       # Deletes a [client session](https://docs.seam.co/core-concepts/authentication/client-session-tokens).
-      # @param client_session_id ID of the client session that you want to delete.
+      # @param client_session_id [String] ID of the client session that you want to delete.
       # @return [nil] OK
       def delete(client_session_id:)
-        @client.post("/client_sessions/delete", {client_session_id: client_session_id}.compact)
+        @client.delete("/client_sessions/delete", {client_session_id: client_session_id}.compact)
 
         nil
       end
 
       # Returns a specified [client session](https://docs.seam.co/core-concepts/authentication/client-session-tokens).
-      # @param client_session_id ID of the client session that you want to get.
-      # @param user_identifier_key User identifier key associated with the client session that you want to get.
+      # @param client_session_id [String, nil] ID of the client session that you want to get.
+      # @param user_identifier_key [String, nil] User identifier key associated with the client session that you want to get.
       # @return [Seam::Resources::ClientSession] OK
       def get(client_session_id: nil, user_identifier_key: nil)
-        res = @client.post("/client_sessions/get", {client_session_id: client_session_id, user_identifier_key: user_identifier_key}.compact)
+        res = @client.get("/client_sessions/get", {client_session_id: client_session_id, user_identifier_key: user_identifier_key}.compact)
 
         Seam::Resources::ClientSession.load_from_response(res.body["client_session"])
       end
 
       # Returns a [client session](https://docs.seam.co/core-concepts/authentication/client-session-tokens) with specific characteristics or creates a new client session with these characteristics if it does not yet exist.
-      # @param connect_webview_ids IDs of the [Connect Webviews](https://docs.seam.co/core-concepts/connect-webviews) that you want to associate with the client session (or that are already associated with the existing client session).
-      # @param connected_account_ids IDs of the [connected accounts](https://docs.seam.co/api/connected_accounts) that you want to associate with the client session (or that are already associated with the existing client session).
-      # @param expires_at Date and time at which the client session should expire in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format. If the client session already exists, this will update the expiration before returning it.
-      # @param user_identifier_key Your user ID for the user that you want to associate with the client session (or that is already associated with the existing client session).
-      # @param user_identity_id ID of the [user identity](https://docs.seam.co/capability-guides/mobile-access/managing-mobile-app-user-accounts-with-user-identities#what-is-a-user-identity) that you want to associate with the client session (or that are already associated with the existing client session).
-      # @param user_identity_ids IDs of the [user identities](https://docs.seam.co/capability-guides/mobile-access/managing-mobile-app-user-accounts-with-user-identities#what-is-a-user-identity) that you want to associate with the client session.
+      # @param connect_webview_ids [Array<String>, nil] IDs of the [Connect Webviews](https://docs.seam.co/core-concepts/connect-webviews) that you want to associate with the client session (or that are already associated with the existing client session).
+      # @param connected_account_ids [Array<String>, nil] IDs of the [connected accounts](https://docs.seam.co/api/connected_accounts) that you want to associate with the client session (or that are already associated with the existing client session).
+      # @param expires_at [Time, nil] Date and time at which the client session should expire in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format. If the client session already exists, this will update the expiration before returning it.
+      # @param user_identifier_key [String, nil] Your user ID for the user that you want to associate with the client session (or that is already associated with the existing client session).
+      # @param user_identity_id [String, nil] ID of the [user identity](https://docs.seam.co/capability-guides/mobile-access/managing-mobile-app-user-accounts-with-user-identities#what-is-a-user-identity) that you want to associate with the client session (or that are already associated with the existing client session).
+      # @param user_identity_ids [Array<String>, nil] IDs of the [user identities](https://docs.seam.co/capability-guides/mobile-access/managing-mobile-app-user-accounts-with-user-identities#what-is-a-user-identity) that you want to associate with the client session.
       # @deprecated user_identity_ids: Use `user_identity_id`.
       # @return [Seam::Resources::ClientSession] OK
       def get_or_create(connect_webview_ids: nil, connected_account_ids: nil, expires_at: nil, user_identifier_key: nil, user_identity_id: nil, user_identity_ids: nil)
@@ -60,29 +60,33 @@ module Seam
       end
 
       # Grants a [client session](https://docs.seam.co/core-concepts/authentication/client-session-tokens) access to one or more resources, such as [Connect Webviews](https://docs.seam.co/core-concepts/connect-webviews), [user identities](https://docs.seam.co/capability-guides/mobile-access/managing-mobile-app-user-accounts-with-user-identities#what-is-a-user-identity), and so on.
-      # @param client_session_id ID of the client session to which you want to grant access to resources.
-      # @param connect_webview_ids IDs of the [Connect Webviews](https://docs.seam.co/core-concepts/connect-webviews) that you want to associate with the client session.
-      # @param connected_account_ids IDs of the [connected accounts](https://docs.seam.co/core-concepts/connected-accounts) that you want to associate with the client session.
-      # @param user_identifier_key Your user ID for the user that you want to associate with the client session.
-      # @param user_identity_id ID of the [user identity](https://docs.seam.co/capability-guides/mobile-access/managing-mobile-app-user-accounts-with-user-identities#what-is-a-user-identity) that you want to associate with the client session.
-      # @param user_identity_ids IDs of the [user identities](https://docs.seam.co/capability-guides/mobile-access/managing-mobile-app-user-accounts-with-user-identities#what-is-a-user-identity) that you want to associate with the client session.
+      # @param client_session_id [String, nil] ID of the client session to which you want to grant access to resources.
+      # @param connect_webview_ids [Array<String>, nil] IDs of the [Connect Webviews](https://docs.seam.co/core-concepts/connect-webviews) that you want to associate with the client session.
+      # @param connected_account_ids [Array<String>, nil] IDs of the [connected accounts](https://docs.seam.co/core-concepts/connected-accounts) that you want to associate with the client session.
+      # @param user_identifier_key [String, nil] Your user ID for the user that you want to associate with the client session.
+      # @param user_identity_id [String, nil] ID of the [user identity](https://docs.seam.co/capability-guides/mobile-access/managing-mobile-app-user-accounts-with-user-identities#what-is-a-user-identity) that you want to associate with the client session.
+      # @param user_identity_ids [Array<String>, nil] IDs of the [user identities](https://docs.seam.co/capability-guides/mobile-access/managing-mobile-app-user-accounts-with-user-identities#what-is-a-user-identity) that you want to associate with the client session.
       # @deprecated user_identity_ids: Use `user_identity_id`.
       # @return [nil] OK
       def grant_access(client_session_id: nil, connect_webview_ids: nil, connected_account_ids: nil, user_identifier_key: nil, user_identity_id: nil, user_identity_ids: nil)
-        @client.post("/client_sessions/grant_access", {client_session_id: client_session_id, connect_webview_ids: connect_webview_ids, connected_account_ids: connected_account_ids, user_identifier_key: user_identifier_key, user_identity_id: user_identity_id, user_identity_ids: user_identity_ids}.compact)
+        if client_session_id.nil? && connect_webview_ids.nil? && connected_account_ids.nil? && user_identifier_key.nil? && user_identity_id.nil? && user_identity_ids.nil?
+          raise TypeError, "At least one parameter is required for /client_sessions/grant_access"
+        end
+
+        @client.patch("/client_sessions/grant_access", {client_session_id: client_session_id, connect_webview_ids: connect_webview_ids, connected_account_ids: connected_account_ids, user_identifier_key: user_identifier_key, user_identity_id: user_identity_id, user_identity_ids: user_identity_ids}.compact)
 
         nil
       end
 
       # Returns a list of all [client sessions](https://docs.seam.co/core-concepts/authentication/client-session-tokens).
-      # @param client_session_id ID of the client session that you want to retrieve.
-      # @param connect_webview_id ID of the [Connect Webview](https://docs.seam.co/core-concepts/connect-webviews) for which you want to retrieve client sessions.
-      # @param user_identifier_key Your user ID for the user by which you want to filter client sessions.
-      # @param user_identity_id ID of the [user identity](https://docs.seam.co/capability-guides/mobile-access/managing-mobile-app-user-accounts-with-user-identities#what-is-a-user-identity) for which you want to retrieve client sessions.
-      # @param without_user_identifier_key Indicates whether to retrieve only client sessions without associated user identifier keys.
+      # @param client_session_id [String, nil] ID of the client session that you want to retrieve.
+      # @param connect_webview_id [String, nil] ID of the [Connect Webview](https://docs.seam.co/core-concepts/connect-webviews) for which you want to retrieve client sessions.
+      # @param user_identifier_key [String, nil] Your user ID for the user by which you want to filter client sessions.
+      # @param user_identity_id [String, nil] ID of the [user identity](https://docs.seam.co/capability-guides/mobile-access/managing-mobile-app-user-accounts-with-user-identities#what-is-a-user-identity) for which you want to retrieve client sessions.
+      # @param without_user_identifier_key [Boolean, nil] Indicates whether to retrieve only client sessions without associated user identifier keys.
       # @return [Seam::Resources::ClientSession] OK
       def list(client_session_id: nil, connect_webview_id: nil, user_identifier_key: nil, user_identity_id: nil, without_user_identifier_key: nil)
-        res = @client.post("/client_sessions/list", {client_session_id: client_session_id, connect_webview_id: connect_webview_id, user_identifier_key: user_identifier_key, user_identity_id: user_identity_id, without_user_identifier_key: without_user_identifier_key}.compact)
+        res = @client.get("/client_sessions/list", {client_session_id: client_session_id, connect_webview_id: connect_webview_id, user_identifier_key: user_identifier_key, user_identity_id: user_identity_id, without_user_identifier_key: without_user_identifier_key}.compact)
 
         Seam::Resources::ClientSession.load_from_response(res.body["client_sessions"])
       end
@@ -90,7 +94,7 @@ module Seam
       # Revokes a [client session](https://docs.seam.co/core-concepts/authentication/client-session-tokens).
       #
       # Note that [deleting a client session](https://docs.seam.co/api/client_sessions/delete) is a separate action.
-      # @param client_session_id ID of the client session that you want to revoke.
+      # @param client_session_id [String] ID of the client session that you want to revoke.
       # @return [nil] OK
       def revoke(client_session_id:)
         @client.post("/client_sessions/revoke", {client_session_id: client_session_id}.compact)