Constructors

Properties

client: AxiosInstance
defaults: Required<SeamHttpRequestOptions>

Methods

  • Parameters

    • Optionalbody: {
          acs_access_group_id: string;
          acs_user_id: string;
      }
      • acs_access_group_id: string

        ID of the access group to which you want to add an access system user.

      • acs_user_id: string

        ID of the access system user that you want to add to an access group.

    Returns SeamHttpRequest<void, undefined>

  • Parameters

    • Optionalbody: {
          access_schedule?: {
              ends_at?: null | string;
              starts_at?: string;
          };
          acs_access_group_ids?: string[];
          acs_system_id: string;
          email?: string;
          email_address?: string;
          full_name: string;
          phone_number?: string;
          user_identity_id?: string;
      }
      • Optionalaccess_schedule?: {
            ends_at?: null | string;
            starts_at?: string;
        }

        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.

        • Optionalends_at?: null | string

          Ending timestamp for the new access system user's access.

        • Optionalstarts_at?: string

          Starting timestamp for the new access system user's access.

      • Optionalacs_access_group_ids?: string[]

        Array of access group IDs to indicate the access groups to which you want to add the new access system user.

      • acs_system_id: string

        ID of the access system to which you want to add the new access system user.

      • Optionalemail?: string

        use email_address.

      • Optionalemail_address?: string

        Email address of the ACS user.

      • full_name: string

        Full name of the new access system user.

      • Optionalphone_number?: string

        Phone number of the ACS user in E.164 format (for example, +15555550100).

      • Optionaluser_identity_id?: string

        ID of the user identity with which you want to associate the new access system user.

    Returns SeamHttpRequest<SetNonNullable<Required<{
        acs_user: {
            access_schedule?: {
                ends_at: null | string;
                starts_at: string;
            };
            acs_system_id: string;
            acs_user_id: string;
            connected_account_id: string;
            created_at: string;
            display_name: string;
            email?: string;
            email_address?: string;
            errors: (
                | {
                    created_at: string;
                    error_code: "deleted_externally";
                    message: string;
                }
                | {
                    created_at: string;
                    error_code: "salto_ks_subscription_limit_exceeded";
                    message: string;
                }
                | {
                    created_at: string;
                    error_code: "failed_to_create_on_acs_system";
                    message: string;
                }
                | {
                    created_at: string;
                    error_code: "failed_to_update_on_acs_system";
                    message: string;
                }
                | {
                    created_at: string;
                    error_code: "failed_to_delete_on_acs_system";
                    message: string;
                }
                | {
                    created_at: string;
                    error_code: "latch_conflict_with_resident_user";
                    message: string;
                })[];
            external_type?:
                | "pti_user"
                | "brivo_user"
                | "hid_credential_manager_user"
                | "salto_site_user"
                | "latch_user"
                | "dormakaba_community_user"
                | "salto_space_user";
            external_type_display_name?: string;
            full_name?: string;
            hid_acs_system_id?: string;
            is_managed: true;
            is_suspended?: boolean;
            last_successful_sync_at: null | string;
            pending_mutations?: (
                | {
                    created_at: string;
                    message: string;
                    mutation_code: "creating";
                }
                | {
                    created_at: string;
                    message: string;
                    mutation_code: "deleting";
                }
                | {
                    created_at: string;
                    from: {
                        email_address?: (...) | (...) | (...);
                        full_name?: (...) | (...) | (...);
                        phone_number?: (...) | (...) | (...);
                    };
                    message: string;
                    mutation_code: "updating_user_information";
                    to: {
                        email_address?: (...) | (...) | (...);
                        full_name?: (...) | (...) | (...);
                        phone_number?: (...) | (...) | (...);
                    };
                }
                | {
                    created_at: string;
                    from: {
                        ends_at: (...) | (...);
                        starts_at: (...) | (...);
                    };
                    message: string;
                    mutation_code: "updating_access_schedule";
                    to: {
                        ends_at: (...) | (...);
                        starts_at: (...) | (...);
                    };
                }
                | {
                    created_at: string;
                    from: {
                        is_suspended: boolean;
                    };
                    message: string;
                    mutation_code: "updating_suspension_state";
                    to: {
                        is_suspended: boolean;
                    };
                }
                | {
                    created_at: string;
                    from: {
                        acs_access_group_id: (...) | (...);
                    };
                    message: string;
                    mutation_code: "updating_group_membership";
                    to: {
                        acs_access_group_id: (...) | (...);
                    };
                })[];
            phone_number?: string;
            user_identity_email_address?: null | string;
            user_identity_full_name?: null | string;
            user_identity_id?: string;
            user_identity_phone_number?: null | string;
            warnings: (
                | {
                    created_at: string;
                    message: string;
                    warning_code: "being_deleted";
                }
                | {
                    created_at: string;
                    message: string;
                    warning_code: "salto_ks_user_not_subscribed";
                }
                | {
                    created_at: string;
                    message: string;
                    warning_code: "unknown_issue_with_acs_user";
                }
                | {
                    created_at: string;
                    message: string;
                    warning_code: "latch_resident_user";
                })[];
            workspace_id: string;
        };
    }>, "acs_user">, "acs_user">

  • Parameters

    • Optionalbody: {
          acs_system_id?: string;
          acs_user_id?: string;
          user_identity_id?: string;
      }
      • Optionalacs_system_id?: string

        ID of the access system that you want to delete. You must provide acs_system_id with user_identity_id.

      • Optionalacs_user_id?: string

        ID of the access system user that you want to delete. You must provide either acs_user_id or user_identity_id

      • Optionaluser_identity_id?: string

        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.

    Returns SeamHttpRequest<void, undefined>

  • Parameters

    • Optionalbody: {
          acs_system_id?: string;
          acs_user_id?: string;
          user_identity_id?: string;
      }
      • Optionalacs_system_id?: string

        ID of the access system that you want to get. You can only provide acs_user_id or user_identity_id.

      • Optionalacs_user_id?: string

        ID of the access system user that you want to get. You can only provide acs_user_id or user_identity_id.

      • Optionaluser_identity_id?: string

        ID of the user identity that you want to get. You can only provide acs_user_id or user_identity_id.

    Returns SeamHttpRequest<SetNonNullable<Required<{
        acs_user: {
            access_schedule?: {
                ends_at: null | string;
                starts_at: string;
            };
            acs_system_id: string;
            acs_user_id: string;
            connected_account_id: string;
            created_at: string;
            display_name: string;
            email?: string;
            email_address?: string;
            errors: (
                | {
                    created_at: string;
                    error_code: "deleted_externally";
                    message: string;
                }
                | {
                    created_at: string;
                    error_code: "salto_ks_subscription_limit_exceeded";
                    message: string;
                }
                | {
                    created_at: string;
                    error_code: "failed_to_create_on_acs_system";
                    message: string;
                }
                | {
                    created_at: string;
                    error_code: "failed_to_update_on_acs_system";
                    message: string;
                }
                | {
                    created_at: string;
                    error_code: "failed_to_delete_on_acs_system";
                    message: string;
                }
                | {
                    created_at: string;
                    error_code: "latch_conflict_with_resident_user";
                    message: string;
                })[];
            external_type?:
                | "pti_user"
                | "brivo_user"
                | "hid_credential_manager_user"
                | "salto_site_user"
                | "latch_user"
                | "dormakaba_community_user"
                | "salto_space_user";
            external_type_display_name?: string;
            full_name?: string;
            hid_acs_system_id?: string;
            is_managed: true;
            is_suspended?: boolean;
            last_successful_sync_at: null | string;
            pending_mutations?: (
                | {
                    created_at: string;
                    message: string;
                    mutation_code: "creating";
                }
                | {
                    created_at: string;
                    message: string;
                    mutation_code: "deleting";
                }
                | {
                    created_at: string;
                    from: {
                        email_address?: (...) | (...) | (...);
                        full_name?: (...) | (...) | (...);
                        phone_number?: (...) | (...) | (...);
                    };
                    message: string;
                    mutation_code: "updating_user_information";
                    to: {
                        email_address?: (...) | (...) | (...);
                        full_name?: (...) | (...) | (...);
                        phone_number?: (...) | (...) | (...);
                    };
                }
                | {
                    created_at: string;
                    from: {
                        ends_at: (...) | (...);
                        starts_at: (...) | (...);
                    };
                    message: string;
                    mutation_code: "updating_access_schedule";
                    to: {
                        ends_at: (...) | (...);
                        starts_at: (...) | (...);
                    };
                }
                | {
                    created_at: string;
                    from: {
                        is_suspended: boolean;
                    };
                    message: string;
                    mutation_code: "updating_suspension_state";
                    to: {
                        is_suspended: boolean;
                    };
                }
                | {
                    created_at: string;
                    from: {
                        acs_access_group_id: (...) | (...);
                    };
                    message: string;
                    mutation_code: "updating_group_membership";
                    to: {
                        acs_access_group_id: (...) | (...);
                    };
                })[];
            phone_number?: string;
            user_identity_email_address?: null | string;
            user_identity_full_name?: null | string;
            user_identity_id?: string;
            user_identity_phone_number?: null | string;
            warnings: (
                | {
                    created_at: string;
                    message: string;
                    warning_code: "being_deleted";
                }
                | {
                    created_at: string;
                    message: string;
                    warning_code: "salto_ks_user_not_subscribed";
                }
                | {
                    created_at: string;
                    message: string;
                    warning_code: "unknown_issue_with_acs_user";
                }
                | {
                    created_at: string;
                    message: string;
                    warning_code: "latch_resident_user";
                })[];
            workspace_id: string;
        };
    }>, "acs_user">, "acs_user">

  • Parameters

    • Optionalbody: {
          acs_system_id?: string;
          created_before?: Date;
          limit?: number;
          page_cursor?: null | string;
          search?: string;
          user_identity_email_address?: string;
          user_identity_id?: string;
          user_identity_phone_number?: string;
      }
      • Optionalacs_system_id?: string

        ID of the acs_system for which you want to retrieve all access system users.

      • Optionalcreated_before?: Date

        Timestamp by which to limit returned access system users. Returns users created before this timestamp.

      • Optionallimit?: number

        Maximum number of records to return per page.

      • Optionalpage_cursor?: null | string

        Identifies the specific page of results to return, obtained from the previous page's next_page_cursor.

      • Optionalsearch?: string

        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.

      • Optionaluser_identity_email_address?: string

        Email address of the user identity for which you want to retrieve all access system users.

      • Optionaluser_identity_id?: string

        ID of the user identity for which you want to retrieve all access system users.

      • Optionaluser_identity_phone_number?: string

        Phone number of the user identity for which you want to retrieve all access system users, in E.164 format (for example, +15555550100).

    Returns SeamHttpRequest<SetNonNullable<Required<{
        acs_users: {
            access_schedule?: {
                ends_at: null | string;
                starts_at: string;
            };
            acs_system_id: string;
            acs_user_id: string;
            connected_account_id: string;
            created_at: string;
            display_name: string;
            email?: string;
            email_address?: string;
            errors: (
                | {
                    created_at: string;
                    error_code: "deleted_externally";
                    message: string;
                }
                | {
                    created_at: string;
                    error_code: "salto_ks_subscription_limit_exceeded";
                    message: string;
                }
                | {
                    created_at: string;
                    error_code: "failed_to_create_on_acs_system";
                    message: string;
                }
                | {
                    created_at: string;
                    error_code: "failed_to_update_on_acs_system";
                    message: string;
                }
                | {
                    created_at: string;
                    error_code: "failed_to_delete_on_acs_system";
                    message: string;
                }
                | {
                    created_at: string;
                    error_code: "latch_conflict_with_resident_user";
                    message: string;
                })[];
            external_type?:
                | "pti_user"
                | "brivo_user"
                | "hid_credential_manager_user"
                | "salto_site_user"
                | "latch_user"
                | "dormakaba_community_user"
                | "salto_space_user";
            external_type_display_name?: string;
            full_name?: string;
            hid_acs_system_id?: string;
            is_managed: true;
            is_suspended?: boolean;
            last_successful_sync_at: null | string;
            pending_mutations?: (
                | {
                    created_at: string;
                    message: string;
                    mutation_code: "creating";
                }
                | {
                    created_at: string;
                    message: string;
                    mutation_code: "deleting";
                }
                | {
                    created_at: string;
                    from: {
                        email_address?: ...;
                        full_name?: ...;
                        phone_number?: ...;
                    };
                    message: string;
                    mutation_code: "updating_user_information";
                    to: {
                        email_address?: ...;
                        full_name?: ...;
                        phone_number?: ...;
                    };
                }
                | {
                    created_at: string;
                    from: {
                        ends_at: ...;
                        starts_at: ...;
                    };
                    message: string;
                    mutation_code: "updating_access_schedule";
                    to: {
                        ends_at: ...;
                        starts_at: ...;
                    };
                }
                | {
                    created_at: string;
                    from: {
                        is_suspended: ...;
                    };
                    message: string;
                    mutation_code: "updating_suspension_state";
                    to: {
                        is_suspended: ...;
                    };
                }
                | {
                    created_at: string;
                    from: {
                        acs_access_group_id: ...;
                    };
                    message: string;
                    mutation_code: "updating_group_membership";
                    to: {
                        acs_access_group_id: ...;
                    };
                })[];
            phone_number?: string;
            user_identity_email_address?: null | string;
            user_identity_full_name?: null | string;
            user_identity_id?: string;
            user_identity_phone_number?: null | string;
            warnings: (
                | {
                    created_at: string;
                    message: string;
                    warning_code: "being_deleted";
                }
                | {
                    created_at: string;
                    message: string;
                    warning_code: "salto_ks_user_not_subscribed";
                }
                | {
                    created_at: string;
                    message: string;
                    warning_code: "unknown_issue_with_acs_user";
                }
                | {
                    created_at: string;
                    message: string;
                    warning_code: "latch_resident_user";
                })[];
            workspace_id: string;
        }[];
        pagination: {
            has_next_page: boolean;
            next_page_cursor: null | string;
            next_page_url: null | string;
        };
    }>, "pagination" | "acs_users">, "acs_users">

  • Parameters

    • Optionalbody: {
          acs_system_id?: string;
          acs_user_id?: string;
          user_identity_id?: string;
      }
      • Optionalacs_system_id?: string

        ID of the access system for which you want to list accessible entrances. You can only provide acs_system_id with user_identity_id.

      • Optionalacs_user_id?: string

        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.

      • Optionaluser_identity_id?: string

        ID of the user identity for whom you want to list accessible entrances. You can only provide acs_user_id or user_identity_id.

    Returns SeamHttpRequest<SetNonNullable<Required<{
        acs_entrances: {
            acs_entrance_id: string;
            acs_system_id: string;
            assa_abloy_vostio_metadata?: {
                door_name: string;
                door_number?: number;
                door_type:
                    | "CommonDoor"
                    | "EntranceDoor"
                    | "GuestDoor"
                    | "Elevator";
                pms_id?: string;
                stand_open?: boolean;
            };
            created_at: string;
            display_name: string;
            dormakaba_community_metadata?: {
                access_point_name: string;
            };
            errors: {
                error_code: string;
                message: string;
            }[];
            latch_metadata?: {
                accessibility_type: string;
                door_name: string;
                door_type: string;
                is_connected: boolean;
            };
            salto_ks_metadata?: {
                battery_level: string;
                door_name: string;
                intrusion_alarm?: boolean;
                left_open_alarm?: boolean;
                lock_type: string;
                locked_state: string;
                online?: boolean;
                privacy_mode?: boolean;
            };
            salto_space_metadata?: {
                door_description?: string;
                door_name: string;
                ext_door_id: string;
            };
            visionline_metadata?: {
                door_category:
                    | "common"
                    | "guest"
                    | "entrance"
                    | "elevator reader"
                    | "common (PMS)";
                door_name: string;
                profiles?: {
                    visionline_door_profile_id: ...;
                    visionline_door_profile_type: ...;
                }[];
            };
        }[];
    }>, "acs_entrances">, "acs_entrances">

  • Parameters

    • Optionalbody: {
          acs_access_group_id: string;
          acs_user_id?: string;
          user_identity_id?: string;
      }
      • acs_access_group_id: string

        ID of the access group from which you want to remove an access system user.

      • Optionalacs_user_id?: string

        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.

      • Optionaluser_identity_id?: string

        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.

    Returns SeamHttpRequest<void, undefined>

  • Parameters

    • Optionalbody: {
          acs_system_id?: string;
          acs_user_id?: string;
          user_identity_id?: string;
      }
      • Optionalacs_system_id?: string

        ID of the access system for which you want to revoke access. You can only provide acs_system_id with user_identity_id.

      • Optionalacs_user_id?: string

        ID of the access system user for whom you want to revoke access. You can only provide acs_user_id or user_identity_id.

      • Optionaluser_identity_id?: string

        ID of the user identity for whom you want to revoke access. You can only provide acs_user_id or user_identity_id.

    Returns SeamHttpRequest<void, undefined>

  • Parameters

    • Optionalbody: {
          acs_system_id?: string;
          acs_user_id?: string;
          user_identity_id?: string;
      }
      • Optionalacs_system_id?: string

        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.

      • Optionalacs_user_id?: string

        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.

      • Optionaluser_identity_id?: string

        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.

    Returns SeamHttpRequest<void, undefined>

  • Parameters

    • Optionalbody: {
          acs_system_id?: string;
          acs_user_id?: string;
          user_identity_id?: string;
      }
      • Optionalacs_system_id?: string

        ID of the access system of the user that you want to unsuspend. You can only provide acs_system_id with user_identity_id.

      • Optionalacs_user_id?: string

        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.

      • Optionaluser_identity_id?: string

        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.

    Returns SeamHttpRequest<void, undefined>

  • Parameters

    • Optionalbody: {
          access_schedule?: null | {
              ends_at: string;
              starts_at: string;
          };
          acs_system_id?: string;
          acs_user_id?: string;
          email?: string;
          email_address?: string;
          full_name?: string;
          hid_acs_system_id?: string;
          phone_number?: string;
          user_identity_id?: string;
      }
      • Optionalaccess_schedule?: null | {
            ends_at: string;
            starts_at: string;
        }

        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.

      • Optionalacs_system_id?: string

        ID of the access system that you want to update. You can only provide acs_system_id with user_identity_id.

      • Optionalacs_user_id?: string

        ID of the access system user that you want to update. You can only provide acs_user_id or user_identity_id.

      • Optionalemail?: string

        use email_address.

      • Optionalemail_address?: string

        Email address of the ACS user.

      • Optionalfull_name?: string

        Full name of the ACS user.

      • Optionalhid_acs_system_id?: string
      • Optionalphone_number?: string

        Phone number of the ACS user in E.164 format (for example, +15555550100).

      • Optionaluser_identity_id?: string

        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.

    Returns SeamHttpRequest<void, undefined>

  • Parameters

    • clientSessionToken: string

    Returns Promise<void>