Class SeamHttpDevices

constructor

• new SeamHttpDevices(apiKeyOrOptions?: string | SeamHttpOptions): SeamHttpDevices

  Parameters

  • apiKeyOrOptions: string | SeamHttpOptions = {}

  Returns SeamHttpDevices

client

Readonlydefaults

ReadonlyltsVersion

StaticltsVersion

simulate

• get simulate(): SeamHttpDevicesSimulate

  Returns SeamHttpDevicesSimulate

unmanaged

• get unmanaged(): SeamHttpDevicesUnmanaged

  Returns SeamHttpDevicesUnmanaged

createPaginator

• createPaginator<
      const TResponse,
      const TResponseKey extends string | number | symbol,
  >(
      request: SeamHttpRequest<TResponse, TResponseKey>,
  ): SeamPaginator<TResponse, TResponseKey>

  Type Parameters

  • const TResponse
  • const TResponseKey extends string | number | symbol

  Parameters

  • request: SeamHttpRequest<TResponse, TResponseKey>

  Returns SeamPaginator<TResponse, TResponseKey>

delete

• delete(
      parameters?: { device_id: string },
      options?: DevicesDeleteOptions,
  ): DevicesDeleteRequest

  Parameters

  • Optionalparameters: { device_id: string }

    • device_id: string

      ID of the device that you want to delete.
  • options: DevicesDeleteOptions = {}

  Returns DevicesDeleteRequest

get

• get(
      parameters?: { device_id?: string; name?: string },
      options?: DevicesGetOptions,
  ): DevicesGetRequest

  Parameters

  • Optionalparameters: { device_id?: string; name?: string }

    • Optionaldevice_id?: string

      ID of the device that you want to get.

    • Optionalname?: string

      Name of the device that you want to get.
  • options: DevicesGetOptions = {}

  Returns DevicesGetRequest

list

• list(
      parameters?: {
          connect_webview_id?: string;
          connected_account_id?: string;
          connected_account_ids?: string[];
          created_before?: Date;
          custom_metadata_has?: { [x: string]: string | boolean };
          customer_key?: string;
          device_ids?: string[];
          device_type?:
              | "akuvox_lock"
              | "august_lock"
              | "brivo_access_point"
              | "butterflymx_panel"
              | "avigilon_alta_entry"
              | "doorking_lock"
              | "genie_door"
              | "igloo_lock"
              | "linear_lock"
              | "lockly_lock"
              | "kwikset_lock"
              | "nuki_lock"
              | "salto_lock"
              | "schlage_lock"
              | "seam_relay"
              | "smartthings_lock"
              | "wyze_lock"
              | "yale_lock"
              | "two_n_intercom"
              | "controlbyweb_device"
              | "ttlock_lock"
              | "igloohome_lock"
              | "hubitat_lock"
              | "four_suites_door"
              | "dormakaba_oracode_door"
              | "tedee_lock"
              | "akiles_lock"
              | "ultraloq_lock"
              | "keynest_key"
              | "noiseaware_activity_zone"
              | "minut_sensor"
              | "ecobee_thermostat"
              | "nest_thermostat"
              | "honeywell_resideo_thermostat"
              | "tado_thermostat"
              | "sensi_thermostat"
              | "smartthings_thermostat"
              | "ios_phone"
              | "android_phone";
          device_types?: (
              | "akuvox_lock"
              | "august_lock"
              | "brivo_access_point"
              | "butterflymx_panel"
              | "avigilon_alta_entry"
              | "doorking_lock"
              | "genie_door"
              | "igloo_lock"
              | "linear_lock"
              | "lockly_lock"
              | "kwikset_lock"
              | "nuki_lock"
              | "salto_lock"
              | "schlage_lock"
              | "seam_relay"
              | "smartthings_lock"
              | "wyze_lock"
              | "yale_lock"
              | "two_n_intercom"
              | "controlbyweb_device"
              | "ttlock_lock"
              | "igloohome_lock"
              | "hubitat_lock"
              | "four_suites_door"
              | "dormakaba_oracode_door"
              | "tedee_lock"
              | "akiles_lock"
              | "ultraloq_lock"
              | "keynest_key"
              | "noiseaware_activity_zone"
              | "minut_sensor"
              | "ecobee_thermostat"
              | "nest_thermostat"
              | "honeywell_resideo_thermostat"
              | "tado_thermostat"
              | "sensi_thermostat"
              | "smartthings_thermostat"
              | "ios_phone"
              | "android_phone"
          )[];
          exclude_if?: (
              | "can_remotely_unlock"
              | "can_remotely_lock"
              | "can_program_offline_access_codes"
              | "can_program_online_access_codes"
              | "can_hvac_heat"
              | "can_hvac_cool"
              | "can_hvac_heat_cool"
              | "can_turn_off_hvac"
              | "can_simulate_removal"
              | "can_simulate_connection"
              | "can_simulate_disconnection"
              | "can_unlock_with_code"
              | "can_run_thermostat_programs"
              | "can_program_thermostat_programs_as_weekday_weekend"
              | "can_program_thermostat_programs_as_different_each_day"
              | "can_program_thermostat_programs_as_same_each_day"
              | "can_simulate_hub_connection"
              | "can_simulate_hub_disconnection"
              | "can_simulate_paid_subscription"
          )[];
          include_if?: (
              | "can_remotely_unlock"
              | "can_remotely_lock"
              | "can_program_offline_access_codes"
              | "can_program_online_access_codes"
              | "can_hvac_heat"
              | "can_hvac_cool"
              | "can_hvac_heat_cool"
              | "can_turn_off_hvac"
              | "can_simulate_removal"
              | "can_simulate_connection"
              | "can_simulate_disconnection"
              | "can_unlock_with_code"
              | "can_run_thermostat_programs"
              | "can_program_thermostat_programs_as_weekday_weekend"
              | "can_program_thermostat_programs_as_different_each_day"
              | "can_program_thermostat_programs_as_same_each_day"
              | "can_simulate_hub_connection"
              | "can_simulate_hub_disconnection"
              | "can_simulate_paid_subscription"
          )[];
          limit?: number;
          manufacturer?: | "akuvox"
          | "august"
          | "avigilon_alta"
          | "brivo"
          | "butterflymx"
          | "schlage"
          | "smartthings"
          | "yale"
          | "genie"
          | "doorking"
          | "salto"
          | "lockly"
          | "ttlock"
          | "linear"
          | "noiseaware"
          | "nuki"
          | "igloo"
          | "kwikset"
          | "minut"
          | "controlbyweb"
          | "nest"
          | "igloohome"
          | "ecobee"
          | "hubitat"
          | "four_suites"
          | "dormakaba_oracode"
          | "wyze"
          | "tedee"
          | "honeywell_resideo"
          | "akiles"
          | "tado"
          | "sensi"
          | "kwikset2"
          | "keynest"
          | "ultraloq"
          | "keywe"
          | "philia"
          | "samsung"
          | "seam"
          | "unknown"
          | "two_n";
          page_cursor?: null
          | string;
          search?: string;
          space_id?: string;
          unstable_location_id?: null | string;
          user_identifier_key?: string;
      },
      options?: DevicesListOptions,
  ): DevicesListRequest

  Parameters

  • Optionalparameters: {
        connect_webview_id?: string;
        connected_account_id?: string;
        connected_account_ids?: string[];
        created_before?: Date;
        custom_metadata_has?: { [x: string]: string | boolean };
        customer_key?: string;
        device_ids?: string[];
        device_type?:
            | "akuvox_lock"
            | "august_lock"
            | "brivo_access_point"
            | "butterflymx_panel"
            | "avigilon_alta_entry"
            | "doorking_lock"
            | "genie_door"
            | "igloo_lock"
            | "linear_lock"
            | "lockly_lock"
            | "kwikset_lock"
            | "nuki_lock"
            | "salto_lock"
            | "schlage_lock"
            | "seam_relay"
            | "smartthings_lock"
            | "wyze_lock"
            | "yale_lock"
            | "two_n_intercom"
            | "controlbyweb_device"
            | "ttlock_lock"
            | "igloohome_lock"
            | "hubitat_lock"
            | "four_suites_door"
            | "dormakaba_oracode_door"
            | "tedee_lock"
            | "akiles_lock"
            | "ultraloq_lock"
            | "keynest_key"
            | "noiseaware_activity_zone"
            | "minut_sensor"
            | "ecobee_thermostat"
            | "nest_thermostat"
            | "honeywell_resideo_thermostat"
            | "tado_thermostat"
            | "sensi_thermostat"
            | "smartthings_thermostat"
            | "ios_phone"
            | "android_phone";
        device_types?: (
            | "akuvox_lock"
            | "august_lock"
            | "brivo_access_point"
            | "butterflymx_panel"
            | "avigilon_alta_entry"
            | "doorking_lock"
            | "genie_door"
            | "igloo_lock"
            | "linear_lock"
            | "lockly_lock"
            | "kwikset_lock"
            | "nuki_lock"
            | "salto_lock"
            | "schlage_lock"
            | "seam_relay"
            | "smartthings_lock"
            | "wyze_lock"
            | "yale_lock"
            | "two_n_intercom"
            | "controlbyweb_device"
            | "ttlock_lock"
            | "igloohome_lock"
            | "hubitat_lock"
            | "four_suites_door"
            | "dormakaba_oracode_door"
            | "tedee_lock"
            | "akiles_lock"
            | "ultraloq_lock"
            | "keynest_key"
            | "noiseaware_activity_zone"
            | "minut_sensor"
            | "ecobee_thermostat"
            | "nest_thermostat"
            | "honeywell_resideo_thermostat"
            | "tado_thermostat"
            | "sensi_thermostat"
            | "smartthings_thermostat"
            | "ios_phone"
            | "android_phone"
        )[];
        exclude_if?: (
            | "can_remotely_unlock"
            | "can_remotely_lock"
            | "can_program_offline_access_codes"
            | "can_program_online_access_codes"
            | "can_hvac_heat"
            | "can_hvac_cool"
            | "can_hvac_heat_cool"
            | "can_turn_off_hvac"
            | "can_simulate_removal"
            | "can_simulate_connection"
            | "can_simulate_disconnection"
            | "can_unlock_with_code"
            | "can_run_thermostat_programs"
            | "can_program_thermostat_programs_as_weekday_weekend"
            | "can_program_thermostat_programs_as_different_each_day"
            | "can_program_thermostat_programs_as_same_each_day"
            | "can_simulate_hub_connection"
            | "can_simulate_hub_disconnection"
            | "can_simulate_paid_subscription"
        )[];
        include_if?: (
            | "can_remotely_unlock"
            | "can_remotely_lock"
            | "can_program_offline_access_codes"
            | "can_program_online_access_codes"
            | "can_hvac_heat"
            | "can_hvac_cool"
            | "can_hvac_heat_cool"
            | "can_turn_off_hvac"
            | "can_simulate_removal"
            | "can_simulate_connection"
            | "can_simulate_disconnection"
            | "can_unlock_with_code"
            | "can_run_thermostat_programs"
            | "can_program_thermostat_programs_as_weekday_weekend"
            | "can_program_thermostat_programs_as_different_each_day"
            | "can_program_thermostat_programs_as_same_each_day"
            | "can_simulate_hub_connection"
            | "can_simulate_hub_disconnection"
            | "can_simulate_paid_subscription"
        )[];
        limit?: number;
        manufacturer?: | "akuvox"
        | "august"
        | "avigilon_alta"
        | "brivo"
        | "butterflymx"
        | "schlage"
        | "smartthings"
        | "yale"
        | "genie"
        | "doorking"
        | "salto"
        | "lockly"
        | "ttlock"
        | "linear"
        | "noiseaware"
        | "nuki"
        | "igloo"
        | "kwikset"
        | "minut"
        | "controlbyweb"
        | "nest"
        | "igloohome"
        | "ecobee"
        | "hubitat"
        | "four_suites"
        | "dormakaba_oracode"
        | "wyze"
        | "tedee"
        | "honeywell_resideo"
        | "akiles"
        | "tado"
        | "sensi"
        | "kwikset2"
        | "keynest"
        | "ultraloq"
        | "keywe"
        | "philia"
        | "samsung"
        | "seam"
        | "unknown"
        | "two_n";
        page_cursor?: null
        | string;
        search?: string;
        space_id?: string;
        unstable_location_id?: null | string;
        user_identifier_key?: string;
    }

    • Optionalconnect_webview_id?: string

      ID of the Connect Webview for which you want to list devices.

    • Optionalconnected_account_id?: string

      ID of the connected account for which you want to list devices.

    • Optionalconnected_account_ids?: string[]

      Array of IDs of the connected accounts for which you want to list devices.

    • Optionalcreated_before?: Date

      Timestamp by which to limit returned devices. Returns devices created before this timestamp.

    • Optionalcustom_metadata_has?: { [x: string]: string | boolean }

      Set of key:value custom metadata pairs for which you want to list devices.

    • Optionalcustomer_key?: string

      Customer key for which you want to list devices.

    • Optionaldevice_ids?: string[]

      Array of device IDs for which you want to list devices.

    • Optionaldevice_type?:
          | "akuvox_lock"
          | "august_lock"
          | "brivo_access_point"
          | "butterflymx_panel"
          | "avigilon_alta_entry"
          | "doorking_lock"
          | "genie_door"
          | "igloo_lock"
          | "linear_lock"
          | "lockly_lock"
          | "kwikset_lock"
          | "nuki_lock"
          | "salto_lock"
          | "schlage_lock"
          | "seam_relay"
          | "smartthings_lock"
          | "wyze_lock"
          | "yale_lock"
          | "two_n_intercom"
          | "controlbyweb_device"
          | "ttlock_lock"
          | "igloohome_lock"
          | "hubitat_lock"
          | "four_suites_door"
          | "dormakaba_oracode_door"
          | "tedee_lock"
          | "akiles_lock"
          | "ultraloq_lock"
          | "keynest_key"
          | "noiseaware_activity_zone"
          | "minut_sensor"
          | "ecobee_thermostat"
          | "nest_thermostat"
          | "honeywell_resideo_thermostat"
          | "tado_thermostat"
          | "sensi_thermostat"
          | "smartthings_thermostat"
          | "ios_phone"
          | "android_phone"

      Device type for which you want to list devices.

    • Optionaldevice_types?: (
          | "akuvox_lock"
          | "august_lock"
          | "brivo_access_point"
          | "butterflymx_panel"
          | "avigilon_alta_entry"
          | "doorking_lock"
          | "genie_door"
          | "igloo_lock"
          | "linear_lock"
          | "lockly_lock"
          | "kwikset_lock"
          | "nuki_lock"
          | "salto_lock"
          | "schlage_lock"
          | "seam_relay"
          | "smartthings_lock"
          | "wyze_lock"
          | "yale_lock"
          | "two_n_intercom"
          | "controlbyweb_device"
          | "ttlock_lock"
          | "igloohome_lock"
          | "hubitat_lock"
          | "four_suites_door"
          | "dormakaba_oracode_door"
          | "tedee_lock"
          | "akiles_lock"
          | "ultraloq_lock"
          | "keynest_key"
          | "noiseaware_activity_zone"
          | "minut_sensor"
          | "ecobee_thermostat"
          | "nest_thermostat"
          | "honeywell_resideo_thermostat"
          | "tado_thermostat"
          | "sensi_thermostat"
          | "smartthings_thermostat"
          | "ios_phone"
          | "android_phone"
      )[]

      Array of device types for which you want to list devices.

    • Optionalexclude_if?: (
          | "can_remotely_unlock"
          | "can_remotely_lock"
          | "can_program_offline_access_codes"
          | "can_program_online_access_codes"
          | "can_hvac_heat"
          | "can_hvac_cool"
          | "can_hvac_heat_cool"
          | "can_turn_off_hvac"
          | "can_simulate_removal"
          | "can_simulate_connection"
          | "can_simulate_disconnection"
          | "can_unlock_with_code"
          | "can_run_thermostat_programs"
          | "can_program_thermostat_programs_as_weekday_weekend"
          | "can_program_thermostat_programs_as_different_each_day"
          | "can_program_thermostat_programs_as_same_each_day"
          | "can_simulate_hub_connection"
          | "can_simulate_hub_disconnection"
          | "can_simulate_paid_subscription"
      )[]

    • Optionalinclude_if?: (
          | "can_remotely_unlock"
          | "can_remotely_lock"
          | "can_program_offline_access_codes"
          | "can_program_online_access_codes"
          | "can_hvac_heat"
          | "can_hvac_cool"
          | "can_hvac_heat_cool"
          | "can_turn_off_hvac"
          | "can_simulate_removal"
          | "can_simulate_connection"
          | "can_simulate_disconnection"
          | "can_unlock_with_code"
          | "can_run_thermostat_programs"
          | "can_program_thermostat_programs_as_weekday_weekend"
          | "can_program_thermostat_programs_as_different_each_day"
          | "can_program_thermostat_programs_as_same_each_day"
          | "can_simulate_hub_connection"
          | "can_simulate_hub_disconnection"
          | "can_simulate_paid_subscription"
      )[]

    • Optionallimit?: number

      Numerical limit on the number of devices to return.

    • Optionalmanufacturer?:
          | "akuvox"
          | "august"
          | "avigilon_alta"
          | "brivo"
          | "butterflymx"
          | "schlage"
          | "smartthings"
          | "yale"
          | "genie"
          | "doorking"
          | "salto"
          | "lockly"
          | "ttlock"
          | "linear"
          | "noiseaware"
          | "nuki"
          | "igloo"
          | "kwikset"
          | "minut"
          | "controlbyweb"
          | "nest"
          | "igloohome"
          | "ecobee"
          | "hubitat"
          | "four_suites"
          | "dormakaba_oracode"
          | "wyze"
          | "tedee"
          | "honeywell_resideo"
          | "akiles"
          | "tado"
          | "sensi"
          | "kwikset2"
          | "keynest"
          | "ultraloq"
          | "keywe"
          | "philia"
          | "samsung"
          | "seam"
          | "unknown"
          | "two_n"

      Manufacturer for which you want to list devices.

    • 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 devices to include all records that satisfy a partial match using device_id, display_name, custom_metadata or location.location_name.

    • Optionalspace_id?: string

      ID of the space for which you want to list devices.

    • Optionalunstable_location_id?: null | string

      Deprecated

      Use space_id.

    • Optionaluser_identifier_key?: string

      Your own internal user ID for the user for which you want to list devices.
  • options: DevicesListOptions = {}

  Returns DevicesListRequest

listDeviceProviders

• listDeviceProviders(
      parameters?: {
          provider_category?:
              | "noise_sensors"
              | "thermostats"
              | "stable"
              | "consumer_smartlocks"
              | "access_control_systems";
      },
      options?: DevicesListDeviceProvidersOptions,
  ): DevicesListDeviceProvidersRequest

  Parameters

  • Optionalparameters: {
        provider_category?:
            | "noise_sensors"
            | "thermostats"
            | "stable"
            | "consumer_smartlocks"
            | "access_control_systems";
    }

    • Optionalprovider_category?:
          | "noise_sensors"
          | "thermostats"
          | "stable"
          | "consumer_smartlocks"
          | "access_control_systems"

      Category for which you want to list providers.
  • options: DevicesListDeviceProvidersOptions = {}

  Returns DevicesListDeviceProvidersRequest

update

• update(
      parameters?: {
          custom_metadata?: { [x: string]: null | string | boolean };
          device_id: string;
          is_managed?: boolean;
          name?: null | string;
          properties?: { name?: null | string };
      },
      options?: DevicesUpdateOptions,
  ): DevicesUpdateRequest

  Parameters

  • Optionalparameters: {
        custom_metadata?: { [x: string]: null | string | boolean };
        device_id: string;
        is_managed?: boolean;
        name?: null | string;
        properties?: { name?: null | string };
    }

    • Optionalcustom_metadata?: { [x: string]: null | string | boolean }

      Custom metadata that you want to associate with the device. Supports up to 50 JSON key:value pairs. Adding custom metadata to a device enables you to store custom information, like customer details or internal IDs from your application. Then, you can filter devices by the desired metadata.

    • device_id: string

      ID of the device that you want to update.

    • Optionalis_managed?: boolean

      Indicates whether the device is managed. To unmanage a device, set is_managed to false.

    • Optionalname?: null | string

      Name for the device.

    • Optionalproperties?: { name?: null | string }

      • Optionalname?: null | string

        Name for the device.
  • options: DevicesUpdateOptions = {}

  Returns DevicesUpdateRequest

updateClientSessionToken

• updateClientSessionToken(clientSessionToken: string): Promise<void>

  Parameters

  • clientSessionToken: string

  Returns Promise<void>

StaticfromApiKey

• fromApiKey(
      apiKey: string,
      options?: Omit<SeamHttpOptionsWithApiKey, "apiKey">,
  ): SeamHttpDevices

  Parameters

  • apiKey: string
  • options: Omit<SeamHttpOptionsWithApiKey, "apiKey"> = {}

  Returns SeamHttpDevices

StaticfromClient

• fromClient(
      client: AxiosInstance,
      options?: Omit<SeamHttpOptionsWithClient, "client">,
  ): SeamHttpDevices

  Parameters

  • client: AxiosInstance
  • options: Omit<SeamHttpOptionsWithClient, "client"> = {}

  Returns SeamHttpDevices

StaticfromClientSessionToken

• fromClientSessionToken(
      clientSessionToken: string,
      options?: Omit<SeamHttpOptionsWithClientSessionToken, "clientSessionToken">,
  ): SeamHttpDevices

  Parameters

  • clientSessionToken: string
  • options: Omit<SeamHttpOptionsWithClientSessionToken, "clientSessionToken"> = {}

  Returns SeamHttpDevices

StaticfromConsoleSessionToken

• fromConsoleSessionToken(
      consoleSessionToken: string,
      workspaceId: string,
      options?: Omit<
          SeamHttpOptionsWithConsoleSessionToken,
          "consoleSessionToken"
          | "workspaceId",
      >,
  ): SeamHttpDevices

  Parameters

  • consoleSessionToken: string
  • workspaceId: string
  • options: Omit<
        SeamHttpOptionsWithConsoleSessionToken,
        "consoleSessionToken"
        | "workspaceId",
    > = {}

  Returns SeamHttpDevices

StaticfromPersonalAccessToken

• fromPersonalAccessToken(
      personalAccessToken: string,
      workspaceId: string,
      options?: Omit<
          SeamHttpOptionsWithPersonalAccessToken,
          "personalAccessToken"
          | "workspaceId",
      >,
  ): SeamHttpDevices

  Parameters

  • personalAccessToken: string
  • workspaceId: string
  • options: Omit<
        SeamHttpOptionsWithPersonalAccessToken,
        "personalAccessToken"
        | "workspaceId",
    > = {}

  Returns SeamHttpDevices

StaticfromPublishableKey

• fromPublishableKey(
      publishableKey: string,
      userIdentifierKey: string,
      options?: SeamHttpFromPublishableKeyOptions,
  ): Promise<SeamHttpDevices>

  Parameters

  • publishableKey: string
  • userIdentifierKey: string
  • options: SeamHttpFromPublishableKeyOptions = {}

  Returns Promise<SeamHttpDevices>