Readonly
defaultsReadonly
ltsStatic
ltsOptional
parameters: { Optional
allow_Optional
attempt_Optional
code?: stringCode to be used for access.
Optional
common_Key to identify access codes that should have the same code. Any two access codes with the same common_code_key
are guaranteed to have the same code
. See also Creating and Updating Multiple Linked Access Codes.
ID of the device for which you want to create the new access code.
Optional
ends_Date and time at which the validity of the new access code ends, in ISO 8601 format. Must be a time in the future and after starts_at
.
Optional
is_Indicates whether external modification of the code is allowed. Default: false
.
Optional
is_Indicates whether the access code is an offline access code.
Optional
is_Indicates whether the offline access code is a single-use access code.
Optional
max_Maximum rounding adjustment. To create a daily-bound offline access code for devices that support this feature, set this parameter to 1d
.
Optional
name?: stringName of the new access code. Enables administrators and users to identify the access code easily, especially when there are numerous access codes.
Note that the name provided on Seam is used to identify the code on Seam and is not necessarily the name that will appear in the lock provider's app or on the device. This is because lock providers may have constraints on names, such as length, uniqueness, or characters that can be used. In addition, some lock providers may break down names into components such as first_name
and last_name
.
To provide a consistent experience, Seam identifies the code on Seam by its name but may modify the name that appears on the lock provider's app or on the device. For example, Seam may add additional characters or truncate the name to meet provider constraints.
To help your users identify codes set by Seam, Seam provides the name exactly as it appears on the lock provider's app or on the device as a separate property called appearance
. This is an object with a name
property and, optionally, first_name
and last_name
properties (for providers that break down a name into components).
Optional
prefer_Indicates whether native scheduling should be used for time-bound codes when supported by the provider. Default: true
.
Optional
preferred_Preferred code length. Only applicable if you do not specify a code
. If the affected device does not support the preferred code length, Seam reverts to using the shortest supported code length.
Optional
starts_Date and time at which the validity of the new access code starts, in ISO 8601 format.
Optional
sync?: booleanOptional
use_Indicates whether to use a backup access code pool provided by Seam. If true
, you can use /access_codes/pull_backup_access_code
.
Optional
use_Optional
options: AccessCodesCreateOptionsOptional
parameters: { Optional
allow_Indicates whether external modification of the code is allowed. Default: false
.
Optional
attempt_Optional
behavior_Desired behavior if any device cannot share a code. If throw
(default), no access codes will be created if any device cannot share a code. If create_random_code
, a random code will be created on devices that cannot share a code.
Optional
code?: stringCode to be used for access.
IDs of the devices for which you want to create the new access codes.
Optional
ends_Date and time at which the validity of the new access code ends, in ISO 8601 format. Must be a time in the future and after starts_at
.
Optional
is_Indicates whether external modification of the code is allowed. Default: false
.
Optional
is_Indicates whether the access code is an offline access code.
Optional
is_Indicates whether the offline access code is a single-use access code.
Optional
max_Maximum rounding adjustment. To create a daily-bound offline access code for devices that support this feature, set this parameter to 1d
.
Optional
name?: stringName of the new access code. Enables administrators and users to identify the access code easily, especially when there are numerous access codes.
Note that the name provided on Seam is used to identify the code on Seam and is not necessarily the name that will appear in the lock provider's app or on the device. This is because lock providers may have constraints on names, such as length, uniqueness, or characters that can be used. In addition, some lock providers may break down names into components such as first_name
and last_name
.
To provide a consistent experience, Seam identifies the code on Seam by its name but may modify the name that appears on the lock provider's app or on the device. For example, Seam may add additional characters or truncate the name to meet provider constraints.
To help your users identify codes set by Seam, Seam provides the name exactly as it appears on the lock provider's app or on the device as a separate property called appearance
. This is an object with a name
property and, optionally, first_name
and last_name
properties (for providers that break down a name into components).
Optional
prefer_Indicates whether native scheduling should be used for time-bound codes when supported by the provider. Default: true
.
Optional
preferred_Preferred code length. Only applicable if you do not specify a code
. If the affected device does not support the preferred code length, Seam reverts to using the shortest supported code length.
Optional
starts_Date and time at which the validity of the new access code starts, in ISO 8601 format.
Optional
use_Indicates whether to use a backup access code pool provided by Seam. If true
, you can use /access_codes/pull_backup_access_code
.
Optional
use_Optional
options: AccessCodesCreateMultipleOptionsOptional
parameters: { ID of the access code that you want to delete.
Optional
device_ID of the device for which you want to delete the access code.
Optional
sync?: booleanOptional
options: AccessCodesDeleteOptionsOptional
parameters: { ID of the device for which you want to generate a code.
Optional
options: AccessCodesGenerateCodeOptionsOptional
parameters: { Optional
access_ID of the access code that you want to get. You must specify either access_code_id
or both device_id
and code
.
Optional
code?: stringCode of the access code that you want to get. You must specify either access_code_id
or both device_id
and code
.
Optional
device_ID of the device containing the access code that you want to get. You must specify either access_code_id
or both device_id
and code
.
Optional
options: AccessCodesGetOptionsOptional
parameters: { Optional
access_IDs of the access codes that you want to retrieve. Specify either device_id
or access_code_ids
.
Optional
customer_Optional
device_ID of the device for which you want to list access codes. Specify either device_id
or access_code_ids
.
Optional
limit?: numberNumerical limit on the number of access codes to return.
Optional
page_Identifies the specific page of results to return, obtained from the previous page's next_page_cursor
.
Optional
user_Your user ID for the user by which to filter access codes.
Optional
options: AccessCodesListOptionsOptional
parameters: { ID of the access code for which you want to pull a backup access code.
Optional
options: AccessCodesPullBackupAccessCodeOptionsOptional
parameters: { ID of the device for which you want to report constraints.
Optional
max_Maximum supported code length as an integer between 4 and 20, inclusive. You can specify either min_code_length
/max_code_length
or supported_code_lengths
.
Optional
min_Minimum supported code length as an integer between 4 and 20, inclusive. You can specify either min_code_length
/max_code_length
or supported_code_lengths
.
Optional
supported_Array of supported code lengths as integers between 4 and 20, inclusive. You can specify either supported_code_lengths
or min_code_length
/max_code_length
.
Optional
options: AccessCodesReportDeviceConstraintsOptionsOptional
parameters: { Code of the simulated unmanaged access code.
ID of the device for which you want to simulate the creation of an unmanaged access code.
Name of the simulated unmanaged access code.
Optional
options: AccessCodesSimulateCreateUnmanagedAccessCodeOptionsOptional
parameters: { ID of the unmanaged access code that you want to convert to a managed access code.
Optional
allow_Indicates whether external modification of the access code is allowed.
Optional
force?: booleanIndicates whether to force the access code conversion. To switch management of an access code from one Seam workspace to another, set force
to true
.
Optional
is_Indicates whether external modification of the access code is allowed.
Optional
sync?: booleanOptional
options: AccessCodesUnmanagedConvertToManagedOptionsOptional
parameters: { ID of the unmanaged access code that you want to delete.
Optional
sync?: booleanOptional
options: AccessCodesUnmanagedDeleteOptionsOptional
parameters: { Optional
access_ID of the unmanaged access code that you want to get. You must specify either access_code_id
or both device_id
and code
.
Optional
code?: stringCode of the unmanaged access code that you want to get. You must specify either access_code_id
or both device_id
and code
.
Optional
device_ID of the device containing the unmanaged access code that you want to get. You must specify either access_code_id
or both device_id
and code
.
Optional
options: AccessCodesUnmanagedGetOptionsOptional
parameters: { ID of the device for which you want to list unmanaged access codes.
Optional
user_Your user ID for the user by which to filter unmanaged access codes.
Optional
options: AccessCodesUnmanagedListOptionsOptional
parameters: { ID of the unmanaged access code that you want to update.
Optional
allow_Indicates whether external modification of the code is allowed.
Optional
force?: booleanIndicates whether to force the unmanaged access code update.
Optional
is_Indicates whether external modification of the code is allowed.
Optional
options: AccessCodesUnmanagedUpdateOptionsOptional
parameters: { ID of the access code that you want to update.
Optional
allow_Indicates whether external modification of the code is allowed. Default: false
.
Optional
attempt_Optional
code?: stringCode to be used for access.
Optional
device_ID of the device containing the access code that you want to update.
Optional
ends_Date and time at which the validity of the new access code ends, in ISO 8601 format. Must be a time in the future and after starts_at
.
Optional
is_Indicates whether external modification of the code is allowed. Default: false
.
Optional
is_Indicates whether the access code is managed through Seam. Note that to convert an unmanaged access code into a managed access code, use /access_codes/unmanaged/convert_to_managed
.
Optional
is_Indicates whether the access code is an offline access code.
Optional
is_Indicates whether the offline access code is a single-use access code.
Optional
max_Maximum rounding adjustment. To create a daily-bound offline access code for devices that support this feature, set this parameter to 1d
.
Optional
name?: stringName of the new access code. Enables administrators and users to identify the access code easily, especially when there are numerous access codes.
Note that the name provided on Seam is used to identify the code on Seam and is not necessarily the name that will appear in the lock provider's app or on the device. This is because lock providers may have constraints on names, such as length, uniqueness, or characters that can be used. In addition, some lock providers may break down names into components such as first_name
and last_name
.
To provide a consistent experience, Seam identifies the code on Seam by its name but may modify the name that appears on the lock provider's app or on the device. For example, Seam may add additional characters or truncate the name to meet provider constraints.
To help your users identify codes set by Seam, Seam provides the name exactly as it appears on the lock provider's app or on the device as a separate property called appearance
. This is an object with a name
property and, optionally, first_name
and last_name
properties (for providers that break down a name into components).
Optional
prefer_Indicates whether native scheduling should be used for time-bound codes when supported by the provider. Default: true
.
Optional
preferred_Preferred code length. Only applicable if you do not specify a code
. If the affected device does not support the preferred code length, Seam reverts to using the shortest supported code length.
Optional
starts_Date and time at which the validity of the new access code starts, in ISO 8601 format.
Optional
sync?: booleanOptional
type?: "ongoing" | "time_bound"Type to which you want to convert the access code. To convert a time-bound access code to an ongoing access code, set type
to ongoing
. See also Changing a time-bound access code to permanent access.
Optional
use_Indicates whether to use a backup access code pool provided by Seam. If true
, you can use /access_codes/pull_backup_access_code
.
Optional
use_Optional
options: AccessCodesUpdateOptionsOptional
parameters: { Key that links the group of access codes, assigned on creation by /access_codes/create_multiple
.
Optional
ends_Date and time at which the validity of the new access code ends, in ISO 8601 format. Must be a time in the future and after starts_at
.
Optional
name?: stringName of the new access code. Enables administrators and users to identify the access code easily, especially when there are numerous access codes.
Note that the name provided on Seam is used to identify the code on Seam and is not necessarily the name that will appear in the lock provider's app or on the device. This is because lock providers may have constraints on names, such as length, uniqueness, or characters that can be used. In addition, some lock providers may break down names into components such as first_name
and last_name
.
To provide a consistent experience, Seam identifies the code on Seam by its name but may modify the name that appears on the lock provider's app or on the device. For example, Seam may add additional characters or truncate the name to meet provider constraints.
To help your users identify codes set by Seam, Seam provides the name exactly as it appears on the lock provider's app or on the device as a separate property called appearance
. This is an object with a name
property and, optionally, first_name
and last_name
properties (for providers that break down a name into components).
Optional
starts_Date and time at which the validity of the new access code starts, in ISO 8601 format.
Optional
options: AccessCodesUpdateMultipleOptionsOptional
parameters: AccessGrantsCreateParametersOptional
options: AccessGrantsCreateOptionsOptional
parameters: { ID of access grant to delete.
Optional
options: AccessGrantsDeleteOptionsOptional
parameters: { ID of access grant to get.
Optional
options: AccessGrantsGetOptionsOptional
parameters: { Optional
acs_ID of entrance to filter list of access grants by.
Optional
acs_ID of system to filter list of access grants by.
Optional
location_Optional
space_ID of space to filter list of access grants by.
Optional
user_ID of user identity to filter list of access grants by.
Optional
options: AccessGrantsListOptionsOptional
parameters: { ID of the access grant to update.
Optional
ends_Date and time at which the validity of the grant ends, in ISO 8601 format. Must be a time in the future and after starts_at
.
Optional
starts_Date and time at which the validity of the grant starts, in ISO 8601 format.
Optional
options: AccessGrantsUpdateOptionsOptional
parameters: { ID of access method to get.
Optional
options: AccessMethodsDeleteOptionsOptional
parameters: { ID of access method to get.
Optional
options: AccessMethodsGetOptionsOptional
parameters: { ID of access grant to list access methods for.
Optional
options: AccessMethodsListOptionsOptional
parameters: { ID of the access group to which you want to add an access system user.
Optional
acs_ID of the access system user that you want to add to an access group. You can only provide one of acs_user_id or user_identity_id.
Optional
user_ID of the desired user identity that you want to add to an access group. 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.
Optional
options: AcsAccessGroupsAddUserOptionsOptional
parameters: { ID of the access group that you want to get.
Optional
options: AcsAccessGroupsGetOptionsOptional
parameters: { Optional
acs_ID of the access system for which you want to retrieve all access groups.
Optional
acs_ID of the access system user for which you want to retrieve all access groups.
Optional
user_ID of the user identity for which you want to retrieve all access groups.
Optional
options: AcsAccessGroupsListOptionsOptional
parameters: { ID of the access group for which you want to retrieve all accessible entrances.
Optional
options: AcsAccessGroupsListAccessibleEntrancesOptionsOptional
parameters: { ID of the access group for which you want to retrieve all access system users.
Optional
options: AcsAccessGroupsListUsersOptionsOptional
parameters: { ID of the access group from which you want to remove an access system user.
Optional
acs_ID of the access system user that you want to remove from an access group.
Optional
user_ID of the user identity associated with the user that you want to remove from an access group.
Optional
options: AcsAccessGroupsRemoveUserOptionsOptional
parameters: { ID of the unmanaged access group that you want to get.
Optional
options: AcsAccessGroupsUnmanagedGetOptionsOptional
parameters: { Optional
acs_ID of the access system for which you want to retrieve all unmanaged access groups.
Optional
acs_ID of the access system user for which you want to retrieve all unmanaged access groups.
Optional
options: AcsAccessGroupsUnmanagedListOptionsOptional
parameters: { ID of the access system for which you want to list credential pools.
Optional
options: AcsCredentialPoolsListOptionsOptional
parameters: { Optional
acs_ID of the credential pool for which you want to launch a credential provisioning automation.
Optional
create_Indicates whether to create an associated credential manager user. If you set create_credential_manager_user
to true
, you cannot specify a credential_manager_acs_user_id
.
Access system ID of the credential manager for which you want to launch a credential provisioning automation.
Optional
credential_ID of the associated access system user within the credential manager. If you specify a credential_manager_acs_user_id
, you cannot set create_credential_manager_user
to true
.
ID of the user identity for which you want to launch a credential provisioning automation.
Optional
options: AcsCredentialProvisioningAutomationsLaunchOptionsOptional
parameters: { ID of the credential that you want to assign to an access system user.
Optional
acs_ID of the access system user to whom you want to assign a credential. You can only provide one of acs_user_id or user_identity_id.
Optional
user_ID of the user identity to whom you want to assign a credential. 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 credential belongs to the ACS user. If the ACS system does not have a corresponding ACS user, one is created.
Optional
options: AcsCredentialsAssignOptionsOptional
parameters: { Access method for the new credential. Supported values: code
, card
, mobile_key
.
Optional
acs_ID of the access system to which the new credential belongs. You must provide either acs_user_id
or the combination of user_identity_id
and acs_system_id
.
Optional
acs_ID of the access system user to whom the new credential belongs. You must provide either acs_user_id
or the combination of user_identity_id
and acs_system_id
.
Optional
allowed_Set of IDs of the entrances for which the new credential grants access.
Optional
assa_Vostio-specific metadata for the new credential.
Optional
auto_Optional
join_Optional
override_Optional
override_Optional
code?: stringAccess (PIN) code for the new credential. There may be manufacturer-specific code restrictions. For details, see the applicable device or system integration guide.
Optional
credential_ACS system ID of the credential manager for the new credential.
Optional
ends_Date and time at which the validity of the new credential ends, in ISO 8601 format. Must be a time in the future and after starts_at
.
Optional
is_Indicates whether the new credential is a multi-phone sync credential.
Optional
salto_Salto Space-specific metadata for the new credential.
Optional
assign_Indicates whether to assign a first, new card to a user. See also Programming Salto Space Card-based Credentials.
Optional
update_Indicates whether to update the user's existing card. See also Programming Salto Space Card-based Credentials.
Optional
starts_Date and time at which the validity of the new credential starts, in ISO 8601 format.
Optional
user_ID of the user identity to whom the new credential belongs. You must provide either acs_user_id
or the combination of user_identity_id
and acs_system_id
. If the access system contains a user with the same email_address
or phone_number
as the user identity that you specify, they are linked, and the credential belongs to the access system user. If the access system does not have a corresponding user, one is created.
Optional
visionline_Visionline-specific metadata for the new credential.
Optional
assa_Optional
auto_Optional
card_Optional
card_Optional
is_Optional
joiner_Optional
override?: booleanOptional
options: AcsCredentialsCreateOptionsOptional
parameters: { ID of the access system user to whom the new credential belongs.
IDs of the acs_entrance
s for which the new credential grants access.
Optional
ends_Date and time at which the validity of the new credential ends, in ISO 8601 format. Must be a time in the future and after starts_at
.
Optional
is_Indicates whether the code is one-time-use or reusable.
Optional
starts_Date and time at which the validity of the new credential starts, in ISO 8601 format.
Optional
options: AcsCredentialsCreateOfflineCodeOptionsOptional
parameters: { ID of the credential that you want to delete.
Optional
options: AcsCredentialsDeleteOptionsOptional
parameters: { ID of the credential that you want to get.
Optional
options: AcsCredentialsGetOptionsOptional
parameters: AcsCredentialsListParametersOptional
options: AcsCredentialsListOptionsOptional
parameters: { ID of the credential for which you want to retrieve all entrances to which the credential grants access.
Optional
options: AcsCredentialsListAccessibleEntrancesOptionsOptional
parameters: { ID of the credential that you want to unassign from an access system user.
Optional
acs_ID of the access system user from which you want to unassign a credential. You can only provide one of acs_user_id or user_identity_id.
Optional
user_ID of the user identity from which you want to unassign a credential. You can only provide one of acs_user_id or user_identity_id.
Optional
options: AcsCredentialsUnassignOptionsOptional
parameters: { ID of the unmanaged credential that you want to get.
Optional
options: AcsCredentialsUnmanagedGetOptionsOptional
parameters: AcsCredentialsUnmanagedListParametersOptional
options: AcsCredentialsUnmanagedListOptionsOptional
parameters: { ID of the credential that you want to update.
Optional
code?: stringReplacement access (PIN) code for the credential that you want to update.
Optional
ends_Replacement date and time at which the validity of the credential ends, in ISO 8601 format. Must be a time in the future and after the starts_at
value that you set when creating the credential.
Optional
options: AcsCredentialsUpdateOptionsOptional
parameters: { ID of the access_method
to encode onto a card.
ID of the acs_encoder
to use to encode the access_method
.
Optional
options: AcsEncodersEncodeAccessMethodOptionsOptional
parameters: { ID of the acs_credential
to encode onto a card.
ID of the acs_encoder
to use to encode the acs_credential
.
Optional
options: AcsEncodersEncodeCredentialOptionsOptional
parameters: { ID of the encoder that you want to get.
Optional
options: AcsEncodersGetOptionsOptional
parameters: AcsEncodersListParametersOptional
options: AcsEncodersListOptionsOptional
parameters: { ID of the encoder to use for the scan.
Optional
options: AcsEncodersScanCredentialOptionsOptional
parameters: AcsEncodersSimulateNextCredentialEncodeWillFailParametersOptional
options: AcsEncodersSimulateNextCredentialEncodeWillFailOptionsOptional
parameters: { ID of the acs_encoder
that will be used in the next request to encode the acs_credential
.
Optional
scenario?: "credential_is_issued"Scenario to simulate.
Optional
options: AcsEncodersSimulateNextCredentialEncodeWillSucceedOptionsOptional
parameters: AcsEncodersSimulateNextCredentialScanWillFailParametersOptional
options: AcsEncodersSimulateNextCredentialScanWillFailOptionsOptional
parameters: AcsEncodersSimulateNextCredentialScanWillSucceedParametersOptional
options: AcsEncodersSimulateNextCredentialScanWillSucceedOptionsOptional
parameters: { ID of the entrance that you want to get.
Optional
options: AcsEntrancesGetOptionsOptional
parameters: { ID of the entrance to which you want to grant an access system user access.
Optional
acs_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.
Optional
user_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.
Optional
options: AcsEntrancesGrantAccessOptionsOptional
parameters: { Optional
access_ID of the access grant for which you want to retrieve all entrances.
Optional
access_ID of the access method for which you want to retrieve all entrances.
Optional
acs_ID of the credential for which you want to retrieve all entrances.
Optional
acs_ID of the access system for which you want to retrieve all entrances.
Optional
location_Optional
space_ID of the space for which you want to list entrances.
Optional
options: AcsEntrancesListOptionsOptional
parameters: { ID of the entrance for which you want to list all credentials that grant access.
Optional
include_Conditions that credentials must meet to be included in the returned list.
Optional
options: AcsEntrancesListCredentialsWithAccessOptionsOptional
parameters: { ID of the access system that you want to get.
Optional
options: AcsSystemsGetOptionsOptional
parameters: { Optional
connected_ID of the connected account by which you want to filter the list of access systems.
Optional
options: AcsSystemsListOptionsOptional
parameters: { ID of the access system for which you want to retrieve all compatible credential manager systems.
Optional
options: AcsSystemsListCompatibleCredentialManagerAcsSystemsOptionsOptional
parameters: { ID of the access group to which you want to add an access system user.
ID of the access system user that you want to add to an access group.
Optional
options: AcsUsersAddToAccessGroupOptionsOptional
parameters: { Optional
access_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
.
Optional
ends_Ending timestamp for the new access system user's access.
Optional
starts_Starting timestamp for the new access system user's access.
Optional
acs_Array of access group IDs to indicate the access groups to which you want to add the new access system user.
ID of the access system to which you want to add the new access system user.
Optional
email?: stringOptional
email_Email address of the access system user.
Full name of the new access system user.
Optional
phone_Phone number of the access system user in E.164 format (for example, +15555550100
).
Optional
user_ID of the user identity with which you want to associate the new access system user.
Optional
options: AcsUsersCreateOptionsOptional
parameters: { Optional
acs_ID of the access system that you want to delete. You must provide acs_system_id with user_identity_id.
Optional
acs_ID of the access system user that you want to delete. You must provide either acs_user_id or user_identity_id
Optional
user_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.
Optional
options: AcsUsersDeleteOptionsOptional
parameters: { Optional
acs_ID of the access system that you want to get. You can only provide acs_user_id or user_identity_id.
Optional
acs_ID of the access system user that you want to get. You can only provide acs_user_id or user_identity_id.
Optional
user_ID of the user identity that you want to get. You can only provide acs_user_id or user_identity_id.
Optional
options: AcsUsersGetOptionsOptional
parameters: { Optional
acs_ID of the acs_system
for which you want to retrieve all access system users.
Optional
created_Timestamp by which to limit returned access system users. Returns users created before this timestamp.
Optional
limit?: numberMaximum number of records to return per page.
Optional
page_Identifies the specific page of results to return, obtained from the previous page's next_page_cursor
.
Optional
search?: stringString 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
.
Optional
user_Email address of the user identity for which you want to retrieve all access system users.
Optional
user_ID of the user identity for which you want to retrieve all access system users.
Optional
user_Phone number of the user identity for which you want to retrieve all access system users, in E.164 format (for example, +15555550100
).
Optional
options: AcsUsersListOptionsOptional
parameters: { Optional
acs_ID of the access system for which you want to list accessible entrances. You can only provide acs_system_id with user_identity_id.
Optional
acs_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.
Optional
user_ID of the user identity for whom you want to list accessible entrances. You can only provide acs_user_id or user_identity_id.
Optional
options: AcsUsersListAccessibleEntrancesOptionsOptional
parameters: { ID of the access group from which you want to remove an access system user.
Optional
acs_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.
Optional
user_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.
Optional
options: AcsUsersRemoveFromAccessGroupOptionsOptional
parameters: { Optional
acs_ID of the access system for which you want to revoke access. You can only provide acs_system_id with user_identity_id.
Optional
acs_ID of the access system user for whom you want to revoke access. You can only provide acs_user_id or user_identity_id.
Optional
user_ID of the user identity for whom you want to revoke access. You can only provide acs_user_id or user_identity_id.
Optional
options: AcsUsersRevokeAccessToAllEntrancesOptionsOptional
parameters: { Optional
acs_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.
Optional
acs_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.
Optional
user_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.
Optional
options: AcsUsersSuspendOptionsOptional
parameters: { ID of the unmanaged access system user that you want to get.
Optional
options: AcsUsersUnmanagedGetOptionsOptional
parameters: { Optional
acs_ID of the access system for which you want to retrieve all unmanaged access system users.
Optional
limit?: numberNumber of unmanaged access system users to return.
Optional
user_Email address of the user identity for which you want to retrieve all unmanaged access system users.
Optional
user_ID of the user identity for which you want to retrieve all unmanaged access system users.
Optional
user_Phone number of the user identity for which you want to retrieve all unmanaged access system users.
Optional
options: AcsUsersUnmanagedListOptionsOptional
parameters: { Optional
acs_ID of the access system of the user that you want to unsuspend. You can only provide acs_system_id with user_identity_id.
Optional
acs_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.
Optional
user_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.
Optional
options: AcsUsersUnsuspendOptionsOptional
parameters: { Optional
access_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
.
Optional
acs_ID of the access system that you want to update. You can only provide acs_system_id with user_identity_id.
Optional
acs_ID of the access system user that you want to update. You can only provide acs_user_id or user_identity_id.
Optional
email?: stringOptional
email_Email address of the access system user.
Optional
full_Full name of the access system user.
Optional
hid_Optional
phone_Phone number of the access system user in E.164 format (for example, +15555550100
).
Optional
user_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.
Optional
options: AcsUsersUpdateOptionsOptional
parameters: { ID of the action attempt that you want to get.
Optional
options: ActionAttemptsGetOptionsOptional
parameters: { IDs of the action attempts that you want to retrieve.
Optional
options: ActionAttemptsListOptionsOptional
parameters: { ID of the Seam Bridge that you want to get.
Optional
options: BridgesGetOptionsOptional
parameters: {}Optional
options: BridgesListOptionsOptional
parameters: { Optional
connect_IDs of the Connect Webviews for which you want to create a client session.
Optional
connected_IDs of the connected accounts for which you want to create a client session.
Optional
customer_Customer ID that you want to associate with the new client session.
Optional
customer_Customer key that you want to associate with the new client session.
Optional
expires_Date and time at which the client session should expire, in ISO 8601 format.
Optional
user_Your user ID for the user for whom you want to create a client session.
Optional
user_ID of the user identity for which you want to create a client session.
Optional
user_IDs of the user identities that you want to associate with the client session.
Optional
options: ClientSessionsCreateOptionsOptional
parameters: { ID of the client session that you want to delete.
Optional
options: ClientSessionsDeleteOptionsOptional
parameters: { Optional
client_ID of the client session that you want to get.
Optional
user_User identifier key associated with the client session that you want to get.
Optional
options: ClientSessionsGetOptionsOptional
parameters: { Optional
connect_IDs of the Connect Webviews that you want to associate with the client session (or that are already associated with the existing client session).
Optional
connected_IDs of the connected accounts that you want to associate with the client session (or that are already associated with the existing client session).
Optional
expires_Date and time at which the client session should expire (or at which the existing client session expires), in ISO 8601 format.
Optional
user_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).
Optional
user_ID of the user identity that you want to associate with the client session (or that are already associated with the existing client session).
Optional
user_IDs of the user identities that you want to associate with the client session.
Optional
options: ClientSessionsGetOrCreateOptionsOptional
parameters: { Optional
client_ID of the client session to which you want to grant access to resources.
Optional
connect_IDs of the Connect Webviews that you want to associate with the client session.
Optional
connected_IDs of the connected accounts that you want to associate with the client session.
Optional
user_Your user ID for the user that you want to associate with the client session.
Optional
user_ID of the user identity that you want to associate with the client session.
Optional
user_IDs of the user identities that you want to associate with the client session.
Optional
options: ClientSessionsGrantAccessOptionsOptional
parameters: { Optional
client_ID of the client session that you want to retrieve.
Optional
connect_ID of the Connect Webview for which you want to retrieve client sessions.
Optional
user_Your user ID for the user by which you want to filter client sessions.
Optional
user_ID of the user identity for which you want to retrieve client sessions.
Optional
without_Indicates whether to retrieve only client sessions without associated user identifier keys.
Optional
options: ClientSessionsListOptionsOptional
parameters: { ID of the client session that you want to revoke.
Optional
options: ClientSessionsRevokeOptionsOptional
parameters: { Optional
accepted_List of accepted device capabilities that restrict the types of devices that can be connected through the Connect Webview. If not provided, defaults will be determined based on the accepted providers.
Optional
accepted_Accepted device provider keys as an alternative to provider_category
. Use this parameter to specify accepted providers explicitly. See Customize the Brands to Display in Your Connect Webviews. To list all provider keys, use /devices/list_device_providers
with no filters.
Optional
automatically_Indicates whether newly-added devices should appear as managed devices. See also: Customize the Behavior Settings of Your Connect Webviews.
Optional
custom_Custom metadata that you want to associate with the Connect Webview. Supports up to 50 JSON key:value pairs. Adding custom metadata to a Connect Webview enables you to store custom information, like customer details or internal IDs from your application. The custom metadata is then transferred to any connected accounts that were connected using the Connect Webview, making it easy to find and filter these resources in your workspace. You can also filter Connect Webviews by custom metadata.
Optional
custom_Alternative URL that you want to redirect the user to on an error. If you do not set this parameter, the Connect Webview falls back to the custom_redirect_url
.
Optional
custom_URL that you want to redirect the user to after the provider login is complete.
Optional
customer_Optional
device_Optional
provider_Specifies the category of providers that you want to include. To list all providers within a category, use /devices/list_device_providers
with the desired provider_category
filter.
Optional
wait_Indicates whether Seam should finish syncing all devices in a newly-connected account before completing the associated Connect Webview. See also: Customize the Behavior Settings of Your Connect Webviews.
Optional
options: ConnectWebviewsCreateOptionsOptional
parameters: { ID of the Connect Webview that you want to delete.
Optional
options: ConnectWebviewsDeleteOptionsOptional
parameters: { ID of the Connect Webview that you want to get.
Optional
options: ConnectWebviewsGetOptionsOptional
parameters: { Optional
custom_Custom metadata pairs by which you want to filter Connect Webviews. Returns Connect Webviews with custom_metadata
that contains all of the provided key:value pairs.
Optional
customer_Optional
limit?: numberMaximum number of records to return per page.
Optional
page_Identifies the specific page of results to return, obtained from the previous page's next_page_cursor
.
Optional
user_Your user ID for the user by which you want to filter Connect Webviews.
Optional
options: ConnectWebviewsListOptionsOptional
parameters: { ID of the connected account that you want to delete.
Optional
sync?: booleanOptional
options: ConnectedAccountsDeleteOptionsOptional
parameters: ConnectedAccountsGetParametersOptional
options: ConnectedAccountsGetOptionsOptional
parameters: { Optional
custom_Custom metadata pairs by which you want to filter connected accounts. Returns connected accounts with custom_metadata
that contains all of the provided key:value pairs.
Optional
customer_Optional
limit?: numberMaximum number of records to return per page.
Optional
page_Identifies the specific page of results to return, obtained from the previous page's next_page_cursor
.
Optional
user_Your user ID for the user by which you want to filter connected accounts.
Optional
options: ConnectedAccountsListOptionsOptional
parameters: { ID of the connected account that you want to sync.
Optional
options: ConnectedAccountsSyncOptionsOptional
parameters: { Optional
automatically_Indicates whether newly-added devices should appear as managed devices.
ID of the connected account that you want to update.
Optional
custom_Custom metadata that you want to associate with the connected account. Supports up to 50 JSON key:value pairs. Adding custom metadata to a connected account enables you to store custom information, like customer details or internal IDs from your application. Then, you can filter connected accounts by the desired metadata.
Optional
options: ConnectedAccountsUpdateOptionsOptional
parameters: CustomersCreatePortalParametersOptional
options: CustomersCreatePortalOptionsOptional
parameters: { Optional
access_List of access grants.
Optional
bookings?: { List of bookings.
Optional
buildings?: { List of buildings.
Optional
common_List of shared common areas.
Your unique identifier for the customer.
Optional
facilities?: { List of gym or fitness facilities.
Optional
guests?: { List of guests.
Optional
listings?: { List of property listings.
Optional
properties?: { List of short-term rental properties.
Optional
reservations?: { List of reservations.
Optional
residents?: { List of residents.
Optional
rooms?: { List of hotel or hospitality rooms.
Optional
spaces?: { List of general spaces or areas.
Optional
tenants?: { List of tenants.
Optional
units?: { List of multi-family residential units.
Optional
user_List of user identities.
Optional
users?: { List of users.
Optional
options: CustomersPushDataOptionsOptional
parameters: { ID of the device that you want to delete.
Optional
options: DevicesDeleteOptionsOptional
parameters: { Optional
device_ID of the device that you want to get.
Optional
name?: stringName of the device that you want to get.
Optional
options: DevicesGetOptionsOptional
parameters: { Optional
connect_ID of the Connect Webview for which you want to list devices.
Optional
connected_ID of the connected account for which you want to list devices.
Optional
connected_Array of IDs of the connected accounts for which you want to list devices.
Optional
created_Timestamp by which to limit returned devices. Returns devices created before this timestamp.
Optional
custom_Set of key:value custom metadata pairs for which you want to list devices.
Optional
customer_Optional
device_Array of device IDs for which you want to list devices.
Optional
device_Device type for which you want to list devices.
Optional
device_Array of device types for which you want to list devices.
Optional
exclude_Optional
include_Optional
limit?: numberNumerical limit on the number of devices to return.
Optional
manufacturer?: Manufacturer for which you want to list devices.
Optional
page_Identifies the specific page of results to return, obtained from the previous page's next_page_cursor
.
Optional
space_ID of the space for which you want to list devices.
Optional
unstable_Optional
user_Your own internal user ID for the user for which you want to list devices.
Optional
options: DevicesListOptionsOptional
parameters: { Optional
provider_Category for which you want to list providers.
Optional
options: DevicesListDeviceProvidersOptionsOptional
parameters: { ID of the device that you want to simulate connecting to Seam.
Optional
options: DevicesSimulateConnectOptionsOptional
parameters: { ID of the device that you want to simulate disconnecting from Seam.
Optional
options: DevicesSimulateDisconnectOptionsOptional
parameters: { ID of the device that you want to simulate removing from Seam.
Optional
options: DevicesSimulateRemoveOptionsOptional
parameters: { Optional
device_ID of the unmanaged device that you want to get.
Optional
name?: stringName of the unmanaged device that you want to get.
Optional
options: DevicesUnmanagedGetOptionsOptional
parameters: { Optional
connect_ID of the Connect Webview for which you want to list devices.
Optional
connected_ID of the connected account for which you want to list devices.
Optional
connected_Array of IDs of the connected accounts for which you want to list devices.
Optional
created_Timestamp by which to limit returned devices. Returns devices created before this timestamp.
Optional
custom_Set of key:value custom metadata pairs for which you want to list devices.
Optional
customer_Optional
device_Array of device IDs for which you want to list devices.
Optional
device_Device type for which you want to list devices.
Optional
device_Array of device types for which you want to list devices.
Optional
exclude_Optional
include_Optional
limit?: numberNumerical limit on the number of devices to return.
Optional
manufacturer?: Manufacturer for which you want to list devices.
Optional
page_Identifies the specific page of results to return, obtained from the previous page's next_page_cursor
.
Optional
space_ID of the space for which you want to list devices.
Optional
unstable_Optional
user_Your own internal user ID for the user for which you want to list devices.
Optional
options: DevicesUnmanagedListOptionsOptional
parameters: { ID of the unmanaged device that you want to update.
Indicates whether the device is managed. Set this parameter to true
to convert an unmanaged device to managed.
Optional
options: DevicesUnmanagedUpdateOptionsOptional
parameters: { Optional
custom_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.
ID of the device that you want to update.
Optional
is_Indicates whether the device is managed. To unmanage a device, set is_managed
to false
.
Optional
name?: null | stringName for the device.
Optional
properties?: { Optional
name?: null | stringName for the device.
Optional
options: DevicesUpdateOptionsOptional
parameters: { Optional
device_Unique identifier for the device that triggered the event that you want to get.
Optional
event_Unique identifier for the event that you want to get.
Optional
event_Type of the event that you want to get.
Optional
options: EventsGetOptionsOptional
parameters: { Optional
access_ID of the access code for which you want to list events.
Optional
access_IDs of the access codes for which you want to list events.
Optional
acs_ID of the access system for which you want to list events.
Optional
acs_IDs of the access systems for which you want to list events.
Optional
between?: (string | Date)[]Lower and upper timestamps to define an exclusive interval containing the events that you want to list. You must include since
or between
.
Optional
connect_IDs of the connected accounts for which you want to list events.
Optional
connected_ID of the connected account for which you want to list events.
Optional
customer_IDs of the customers for which you want to list events.
Optional
device_ID of the device for which you want to list events.
Optional
device_IDs of the devices for which you want to list events.
Optional
event_IDs of the events that you want to list.
Optional
event_Type of the events that you want to list.
Optional
event_Types of the events that you want to list.
Optional
limit?: numberNumerical limit on the number of events to return.
Optional
since?: stringTimestamp to indicate the beginning generation time for the events that you want to list. You must include since
or between
.
Optional
unstable_Offset for the events that you want to list.
Optional
options: EventsListOptionsOptional
parameters: { Optional
device_ID of the lock that you want to get.
Optional
name?: stringName of the lock that you want to get.
Optional
options: LocksGetOptionsOptional
parameters: { Optional
connect_ID of the Connect Webview for which you want to list devices.
Optional
connected_ID of the connected account for which you want to list devices.
Optional
connected_Array of IDs of the connected accounts for which you want to list devices.
Optional
created_Timestamp by which to limit returned devices. Returns devices created before this timestamp.
Optional
custom_Set of key:value custom metadata pairs for which you want to list devices.
Optional
customer_Optional
device_Array of device IDs for which you want to list devices.
Optional
device_Device type of the locks that you want to list.
Optional
device_Device types of the locks that you want to list.
Optional
exclude_Optional
include_Optional
limit?: numberNumerical limit on the number of devices to return.
Optional
manufacturer?: Manufacturer of the locks that you want to list.
Optional
page_Identifies the specific page of results to return, obtained from the previous page's next_page_cursor
.
Optional
space_ID of the space for which you want to list devices.
Optional
unstable_Optional
user_Your own internal user ID for the user for which you want to list devices.
Optional
options: LocksListOptionsOptional
parameters: { ID of the lock that you want to lock.
Optional
sync?: booleanOptional
options: LocksLockDoorOptionsOptional
parameters: { Code that you want to simulate entering on a keypad.
ID of the device for which you want to simulate a keypad code entry.
Optional
options: LocksSimulateKeypadCodeEntryOptionsOptional
parameters: { ID of the device for which you want to simulate a manual lock action using a keypad.
Optional
options: LocksSimulateManualLockViaKeypadOptionsOptional
parameters: { ID of the lock that you want to unlock.
Optional
sync?: booleanOptional
options: LocksUnlockDoorOptionsOptional
parameters: { Optional
options: NetworksGetOptionsOptional
parameters: {}Optional
options: NetworksListOptionsOptional
parameters: { Optional
connect_ID of the Connect Webview for which you want to list devices.
Optional
connected_ID of the connected account for which you want to list devices.
Optional
connected_Array of IDs of the connected accounts for which you want to list devices.
Optional
created_Timestamp by which to limit returned devices. Returns devices created before this timestamp.
Optional
custom_Set of key:value custom metadata pairs for which you want to list devices.
Optional
customer_Optional
device_Array of device IDs for which you want to list devices.
Optional
device_Device type of the noise sensors that you want to list.
Optional
device_Device types of the noise sensors that you want to list.
Optional
exclude_Optional
include_Optional
limit?: numberNumerical limit on the number of devices to return.
Optional
manufacturer?: "noiseaware" | "minut"Manufacturers of the noise sensors that you want to list.
Optional
page_Identifies the specific page of results to return, obtained from the previous page's next_page_cursor
.
Optional
space_ID of the space for which you want to list devices.
Optional
unstable_Optional
user_Your own internal user ID for the user for which you want to list devices.
Optional
options: NoiseSensorsListOptionsOptional
parameters: { ID of the device for which you want to create a noise threshold.
Time at which the new noise threshold should become inactive daily.
Optional
name?: stringName of the new noise threshold.
Optional
noise_Noise level in decibels for the new noise threshold.
Optional
noise_Noise level in Noiseaware Noise Risk Score (NRS) for the new noise threshold. This parameter is only relevant for Noiseaware sensors.
Time at which the new noise threshold should become active daily.
Optional
sync?: booleanOptional
options: NoiseSensorsNoiseThresholdsCreateOptionsOptional
parameters: { ID of the device that contains the noise threshold that you want to delete.
ID of the noise threshold that you want to delete.
Optional
sync?: booleanOptional
options: NoiseSensorsNoiseThresholdsDeleteOptionsOptional
parameters: { ID of the noise threshold that you want to get.
Optional
options: NoiseSensorsNoiseThresholdsGetOptionsOptional
parameters: { ID of the device for which you want to list noise thresholds.
Optional
is_Enables you to limit the returned noise thresholds by whether they are programmed on the noise sensor. To list only noise thresholds that are programmed on the noise sensor, set this parameter to true
. To list only noise thresholds that are not programmed on the noise sensor, se this parameter to false
.
Optional
options: NoiseSensorsNoiseThresholdsListOptionsOptional
parameters: { ID of the device that contains the noise threshold that you want to update.
Optional
ends_Time at which the noise threshold should become inactive daily.
Optional
name?: stringName of the noise threshold that you want to update.
Optional
noise_Noise level in decibels for the noise threshold.
ID of the noise threshold that you want to update.
Optional
noise_Noise level in Noiseaware Noise Risk Score (NRS) for the noise threshold. This parameter is only relevant for Noiseaware sensors.
Optional
starts_Time at which the noise threshold should become active daily.
Optional
sync?: booleanOptional
options: NoiseSensorsNoiseThresholdsUpdateOptionsOptional
parameters: { ID of the device for which you want to simulate the triggering of a noise threshold.
Optional
options: NoiseSensorsSimulateTriggerNoiseThresholdOptionsOptional
parameters: { Device ID of the phone that you want to deactivate.
Optional
options: PhonesDeactivateOptionsOptional
parameters: { Device ID of the phone that you want to get.
Optional
options: PhonesGetOptionsOptional
parameters: { Optional
acs_ID of the credential by which you want to filter the list of returned phones.
Optional
owner_ID of the user identity that represents the owner by which you want to filter the list of returned phones.
Optional
options: PhonesListOptionsOptional
parameters: { Optional
assa_ASSA ABLOY metadata that you want to associate with the simulated phone.
Optional
application_Application version that you want to use for the simulated phone.
Optional
ble_Indicates whether the simulated phone should have Bluetooth low energy (BLE) capability.
Optional
hce_Indicates whether the simulated phone should have host card emulation (HCE) capability.
Optional
nfc_Indicates whether the simulated phone should have near-field communication (NFC) capability.
Optional
seos_SEOS applet version that you want to use for the simulated phone.
Optional
seos_ID of the SEOS trusted service manager (TSM) endpoint that you want to use for the simulated phone.
Optional
custom_ID of the custom SDK installation that you want to use for the simulated phone.
Optional
phone_Metadata that you want to associate with the simulated phone.
Optional
device_Manufacturer that you want to use for the simulated phone.
Optional
device_Device model that you want to use for the simulated phone.
Optional
operating_Mobile operating system that you want to use for the simulated phone.
Optional
os_Mobile operating system version that you want to use for the simulated phone.
ID of the user identity that you want to associate with the simulated phone.
Optional
options: PhonesSimulateCreateSandboxPhoneOptionsOptional
parameters: { Customer portal ID.
Optional
options: SeamCustomerV1PortalsGetOptionsOptional
parameters: { Optional
business_Business vertical to set on the workspace.
Optional
options: SeamCustomerV1SettingsUpdateOptionsOptional
parameters: { Optional
collection_Collection key.
Optional
options: SeamPartnerV1BuildingBlocksSpacesAutoMapOptionsOptional
parameters: { IDs of the entrances that you want to add to the space.
ID of the space to which you want to add entrances.
Optional
options: SpacesAddAcsEntrancesOptionsOptional
parameters: { IDs of the devices that you want to add to the space.
ID of the space to which you want to add devices.
Optional
options: SpacesAddDevicesOptionsOptional
parameters: { Optional
acs_IDs of the entrances that you want to add to the new space.
Optional
device_IDs of the devices that you want to add to the new space.
Name of the space that you want to create.
Optional
options: SpacesCreateOptionsOptional
parameters: { ID of the space that you want to delete.
Optional
options: SpacesDeleteOptionsOptional
parameters: { ID of the space that you want to get.
Optional
options: SpacesGetOptionsOptional
parameters: {}Optional
options: SpacesListOptionsOptional
parameters: { IDs of the entrances that you want to remove from the space.
ID of the space from which you want to remove entrances.
Optional
options: SpacesRemoveAcsEntrancesOptionsOptional
parameters: { IDs of the devices that you want to remove from the space.
ID of the space from which you want to remove devices.
Optional
options: SpacesRemoveDevicesOptionsOptional
parameters: { Optional
name?: stringName of the space.
ID of the space that you want to update.
Optional
options: SpacesUpdateOptionsOptional
parameters: { Climate preset key of the climate preset that you want to activate.
ID of the thermostat device for which you want to activate a climate preset.
Optional
options: ThermostatsActivateClimatePresetOptionsOptional
parameters: { Optional
cooling_Cooling set point in °C that you want to set for the thermostat. You must set one of the cooling_set_point
parameters.
Optional
cooling_Cooling set point in °F that you want to set for the thermostat. You must set one of the cooling_set_point
parameters.
ID of the thermostat device that you want to set to cool mode.
Optional
sync?: booleanOptional
options: ThermostatsCoolOptionsOptional
parameters: { Unique key to identify the climate preset.
Optional
cooling_Temperature to which the thermostat should cool (in °C). See also Set Points.
Optional
cooling_Temperature to which the thermostat should cool (in °F). See also Set Points.
ID of the thermostat device for which you want create a climate preset.
Optional
fan_Desired fan mode setting, such as on
, auto
, or circulate
.
Optional
heating_Temperature to which the thermostat should heat (in °C). See also Set Points.
Optional
heating_Temperature to which the thermostat should heat (in °F). See also Set Points.
Optional
hvac_Desired HVAC mode setting, such as heat
, cool
, heat_cool
, or off
.
Optional
manual_Indicates whether a person at the thermostat or using the API can change the thermostat's settings.
Optional
name?: null | stringUser-friendly name to identify the climate preset.
Optional
options: ThermostatsCreateClimatePresetOptionsOptional
parameters: { ID of the thermostat device for which you want to create a daily program.
Name of the thermostat daily program.
Array of thermostat daily program periods.
Optional
options: ThermostatsDailyProgramsCreateOptionsOptional
parameters: { ID of the thermostat daily program that you want to delete.
Optional
options: ThermostatsDailyProgramsDeleteOptionsOptional
parameters: { Name of the thermostat daily program that you want to update.
Array of thermostat daily program periods. The periods that you specify overwrite any existing periods for the daily program.
ID of the thermostat daily program that you want to update.
Optional
options: ThermostatsDailyProgramsUpdateOptionsOptional
parameters: { Climate preset key of the climate preset that you want to delete.
ID of the thermostat device for which you want to delete a climate preset.
Optional
options: ThermostatsDeleteClimatePresetOptionsOptional
parameters: { Optional
device_ID of the thermostat device that you want to get.
Optional
name?: stringName of the thermostat device that you want to retrieve.
Optional
options: ThermostatsGetOptionsOptional
parameters: { ID of the thermostat device that you want to set to heat mode.
Optional
heating_Heating set point in °C that you want to set for the thermostat. You must set one of the heating_set_point
parameters.
Optional
heating_Heating set point in °F that you want to set for the thermostat. You must set one of the heating_set_point
parameters.
Optional
sync?: booleanOptional
options: ThermostatsHeatOptionsOptional
parameters: { Optional
cooling_Cooling set point in °C that you want to set for the thermostat. You must set one of the cooling_set_point
parameters.
Optional
cooling_Cooling set point in °F that you want to set for the thermostat. You must set one of the cooling_set_point
parameters.
ID of the thermostat device that you want to set to heat-cool mode.
Optional
heating_Heating set point in °C that you want to set for the thermostat. You must set one of the heating_set_point
parameters.
Optional
heating_Heating set point in °F that you want to set for the thermostat. You must set one of the heating_set_point
parameters.
Optional
sync?: booleanOptional
options: ThermostatsHeatCoolOptionsOptional
parameters: { Optional
connect_ID of the Connect Webview for which you want to list devices.
Optional
connected_ID of the connected account for which you want to list devices.
Optional
connected_Array of IDs of the connected accounts for which you want to list devices.
Optional
created_Timestamp by which to limit returned devices. Returns devices created before this timestamp.
Optional
custom_Set of key:value custom metadata pairs for which you want to list devices.
Optional
customer_Optional
device_Array of device IDs for which you want to list devices.
Optional
device_Device type by which you want to filter thermostat devices.
Optional
device_Array of device types by which you want to filter thermostat devices.
Optional
exclude_Optional
include_Optional
limit?: numberNumerical limit on the number of devices to return.
Optional
manufacturer?: Manufacturer by which you want to filter thermostat devices.
Optional
page_Identifies the specific page of results to return, obtained from the previous page's next_page_cursor
.
Optional
space_ID of the space for which you want to list devices.
Optional
unstable_Optional
user_Your own internal user ID for the user for which you want to list devices.
Optional
options: ThermostatsListOptionsOptional
parameters: { ID of the thermostat device that you want to set to off mode.
Optional
sync?: booleanOptional
options: ThermostatsOffOptionsOptional
parameters: { Key of the climate preset to use for the new thermostat schedule.
ID of the thermostat device for which you want to create a schedule.
Date and time at which the new thermostat schedule ends, in ISO 8601 format.
Optional
is_Indicates whether a person at the thermostat or using the API can change the thermostat's settings while the new schedule is active. See also Specifying Manual Override Permissions.
Optional
max_Number of minutes for which a person at the thermostat or using the API can change the thermostat's settings after the activation of the scheduled climate preset. See also Specifying Manual Override Permissions.
Optional
name?: stringName of the thermostat schedule.
Date and time at which the new thermostat schedule starts, in ISO 8601 format.
Optional
options: ThermostatsSchedulesCreateOptionsOptional
parameters: { ID of the thermostat schedule that you want to delete.
Optional
options: ThermostatsSchedulesDeleteOptionsOptional
parameters: { ID of the thermostat schedule that you want to get.
Optional
options: ThermostatsSchedulesGetOptionsOptional
parameters: { ID of the thermostat device for which you want to list schedules.
Optional
user_User identifier key by which to filter the list of returned thermostat schedules.
Optional
options: ThermostatsSchedulesListOptionsOptional
parameters: { Optional
climate_Key of the climate preset to use for the thermostat schedule.
Optional
ends_Date and time at which the thermostat schedule ends, in ISO 8601 format.
Optional
is_Indicates whether a person at the thermostat or using the API can change the thermostat's settings while the schedule is active. See also Specifying Manual Override Permissions.
Optional
max_Number of minutes for which a person at the thermostat or using the API can change the thermostat's settings after the activation of the scheduled climate preset. See also Specifying Manual Override Permissions.
Optional
name?: stringName of the thermostat schedule.
Optional
starts_Date and time at which the thermostat schedule starts, in ISO 8601 format.
ID of the thermostat schedule that you want to update.
Optional
options: ThermostatsSchedulesUpdateOptionsOptional
parameters: { Climate preset key of the climate preset that you want to set as the fallback climate preset.
ID of the thermostat device for which you want to set the fallback climate preset.
Optional
options: ThermostatsSetFallbackClimatePresetOptionsOptional
parameters: { ID of the thermostat device for which you want to set the fan mode.
Optional
fan_Optional
fan_Fan mode setting that you want to set for the thermostat.
Optional
sync?: booleanOptional
options: ThermostatsSetFanModeOptionsOptional
parameters: ThermostatsSetHvacModeParametersOptional
options: ThermostatsSetHvacModeOptionsOptional
parameters: { ID of the thermostat device for which you want to set a temperature threshold.
Optional
lower_Lower temperature limit in in °C. Seam alerts you if the reported temperature is lower than this value. You can specify either lower_limit
but not both.
Optional
lower_Lower temperature limit in in °F. Seam alerts you if the reported temperature is lower than this value. You can specify either lower_limit
but not both.
Optional
upper_Upper temperature limit in in °C. Seam alerts you if the reported temperature is higher than this value. You can specify either upper_limit
but not both.
Optional
upper_Upper temperature limit in in °C. Seam alerts you if the reported temperature is higher than this value. You can specify either upper_limit
but not both.
Optional
options: ThermostatsSetTemperatureThresholdOptionsOptional
parameters: ThermostatsSimulateHvacModeAdjustedParametersOptional
options: ThermostatsSimulateHvacModeAdjustedOptionsOptional
parameters: { ID of the thermostat device that you want to simulate reaching a specified temperature.
Optional
temperature_Temperature in °C that you want simulate the thermostat reaching. You must set temperature_celsius
or temperature_fahrenheit
.
Optional
temperature_Temperature in °F that you want simulate the thermostat reaching. You must set temperature_fahrenheit
or temperature_celsius
.
Optional
options: ThermostatsSimulateTemperatureReachedOptionsOptional
parameters: { Unique key to identify the climate preset.
Optional
cooling_Temperature to which the thermostat should cool (in °C). See also Set Points.
Optional
cooling_Temperature to which the thermostat should cool (in °F). See also Set Points.
ID of the thermostat device for which you want to update a climate preset.
Optional
fan_Desired fan mode setting, such as on
, auto
, or circulate
.
Optional
heating_Temperature to which the thermostat should heat (in °C). See also Set Points.
Optional
heating_Temperature to which the thermostat should heat (in °F). See also Set Points.
Optional
hvac_Desired HVAC mode setting, such as heat
, cool
, heat_cool
, or off
.
Optional
manual_Indicates whether a person at the thermostat can change the thermostat's settings. See Specifying Manual Override Permissions.
Optional
name?: null | stringUser-friendly name to identify the climate preset.
Optional
options: ThermostatsUpdateClimatePresetOptionsOptional
parameters: { ID of the thermostat device for which you want to update the weekly program.
Optional
friday_ID of the thermostat daily program to run on Fridays.
Optional
monday_ID of the thermostat daily program to run on Mondays.
Optional
saturday_ID of the thermostat daily program to run on Saturdays.
Optional
sunday_ID of the thermostat daily program to run on Sundays.
Optional
thursday_ID of the thermostat daily program to run on Thursdays.
Optional
tuesday_ID of the thermostat daily program to run on Tuesdays.
Optional
wednesday_ID of the thermostat daily program to run on Wednesdays.
Optional
options: ThermostatsUpdateWeeklyProgramOptionsOptional
parameters: UnstableAccessGrantsCreateParametersOptional
options: UnstableAccessGrantsCreateOptionsOptional
parameters: { ID of access grant that you want to delete.
Optional
options: UnstableAccessGrantsDeleteOptionsOptional
parameters: { ID of access grant that you want to get.
Optional
options: UnstableAccessGrantsGetOptionsOptional
parameters: { Optional
acs_ID of the entrance by which you want to filter the list of access grants.
Optional
acs_ID of the access system by which you want to filter the list of access grants.
Optional
location_Optional
space_ID of the space by which you want to filter the list of access grants.
Optional
user_ID of the user identity by which you want to filter the list of access grants.
Optional
options: UnstableAccessGrantsListOptionsOptional
parameters: { ID of the access method that you want to delete.
Optional
options: UnstableAccessMethodsDeleteOptionsOptional
parameters: { ID of the access method that you want to get.
Optional
options: UnstableAccessMethodsGetOptionsOptional
parameters: { ID of the access grant by which to filter the list of access methods.
Optional
options: UnstableAccessMethodsListOptionsOptional
parameters: { IDs of the entrances that you want to add to the location.
ID of the location to which you want to add entrances.
Optional
options: UnstableLocationsAddAcsEntrancesOptionsOptional
parameters: { IDs of the devices that you want to add to the location.
ID of the location to which you want to add devices.
Optional
options: UnstableLocationsAddDevicesOptionsOptional
parameters: { Optional
acs_IDs of the entrances that you want to add to the new location.
Optional
device_IDs of the devices that you want to add to the new location.
Optional
geolocation?: { Geolocation of the new location.
Name of the new location.
Optional
time_Time zone of the new location.
Optional
options: UnstableLocationsCreateOptionsOptional
parameters: { ID of the location that you want to delete.
Optional
options: UnstableLocationsDeleteOptionsOptional
parameters: { ID of the location that you want to get.
Optional
options: UnstableLocationsGetOptionsOptional
parameters: {}Optional
options: UnstableLocationsListOptionsOptional
parameters: { IDs of the entrances that you want to remove from the location.
ID of the location from which you want to remove entrances.
Optional
options: UnstableLocationsRemoveAcsEntrancesOptionsOptional
parameters: { IDs of the devices that you want to remove from the location.
ID of the location from which you want to remove devices.
Optional
options: UnstableLocationsRemoveDevicesOptionsOptional
parameters: { Optional
geolocation?: { Geolocation of the location.
ID of the location that you want to update.
Optional
name?: stringName of the location.
Optional
time_Time zone of the the location.
Optional
options: UnstableLocationsUpdateOptionsOptional
parameters: { Customer key for which you want to connect accounts.
Optional
options: UnstablePartnerBuildingBlocksConnectAccountsOptionsOptional
parameters: { Type of building block for which you want to create a magic link.
Customer key for which you want to create a new building block magic link.
Optional
spaces?: { Optional list of spaces that you want to include in the new building block magic link.
Optional
options: UnstablePartnerBuildingBlocksGenerateMagicLinkOptionsOptional
parameters: { Customer key for which you want to manage devices.
Optional
options: UnstablePartnerBuildingBlocksManageDevicesOptionsOptional
parameters: { Customer key for which you want to organize spaces.
Optional
spaces?: { Optional list of spaces that you want to include in the new building block magic link.
Optional
options: UnstablePartnerBuildingBlocksOrganizeSpacesOptionsOptional
parameters: { ID of the access system user that you want to add to the user identity.
ID of the user identity to which you want to add an access system user.
Optional
options: UserIdentitiesAddAcsUserOptionsOptional
parameters: { Optional
acs_List of access system IDs to associate with the new user identity through access system users. If there's no user with the same email address or phone number in the specified access systems, a new access system user is created. If there is an existing user with the same email or phone number in the specified access systems, the user is linked to the user identity.
Optional
email_Unique email address for the new user identity.
Optional
full_Full name of the user associated with the new user identity.
Optional
phone_Unique phone number for the new user identity in E.164 format (for example, +15555550100).
Optional
user_Unique key for the new user identity.
Optional
options: UserIdentitiesCreateOptionsOptional
parameters: { ID of the user identity that you want to delete.
Optional
options: UserIdentitiesDeleteOptionsOptional
parameters: { ID of the enrollment automation that you want to delete.
Optional
options: UserIdentitiesEnrollmentAutomationsDeleteOptionsOptional
parameters: { ID of the enrollment automation that you want to get.
Optional
options: UserIdentitiesEnrollmentAutomationsGetOptionsOptional
parameters: { Optional
acs_ID of the credential pool from which to obtain credentials for the user identity.
Optional
create_Indicates whether to create an associated credential manager user. If you set create_credential_manager_user
to true
, you cannot specify a credential_manager_acs_user_id
.
ID of the desired access system that serves as the credential manager for the enrollment automation.
Optional
credential_ID of the associated access system user within the credential manager. If you specify a credential_manager_acs_user_id
, you cannot set create_credential_manager_user
to true
.
ID of the user identity for which you want to launch an enrollment automation.
Optional
options: UserIdentitiesEnrollmentAutomationsLaunchOptionsOptional
parameters: { ID of the user identity for which you want to retrieve enrollment automations.
Optional
options: UserIdentitiesEnrollmentAutomationsListOptionsOptional
parameters: { Optional
max_Maximum number of times the instant key can be used. Default: 1.
ID of the user identity for which you want to generate an instant key.
Optional
options: UserIdentitiesGenerateInstantKeyOptionsOptional
parameters: UserIdentitiesGetParametersOptional
options: UserIdentitiesGetOptionsOptional
parameters: { ID of the managed device to which you want to grant access to the user identity.
ID of the user identity that you want to grant access to a device.
Optional
options: UserIdentitiesGrantAccessToDeviceOptionsOptional
parameters: { Optional
credential_acs_system_id
of the credential manager by which you want to filter the list of user identities.
Optional
options: UserIdentitiesListOptionsOptional
parameters: { ID of the user identity for which you want to retrieve all accessible devices.
Optional
options: UserIdentitiesListAccessibleDevicesOptionsOptional
parameters: { ID of the user identity for which you want to retrieve all access systems.
Optional
options: UserIdentitiesListAcsSystemsOptionsOptional
parameters: { ID of the user identity for which you want to retrieve all access system users.
Optional
options: UserIdentitiesListAcsUsersOptionsOptional
parameters: { ID of the access system user that you want to remove from the user identity..
ID of the user identity from which you want to remove an access system user.
Optional
options: UserIdentitiesRemoveAcsUserOptionsOptional
parameters: { ID of the managed device to which you want to revoke access from the user identity.
ID of the user identity from which you want to revoke access to a device.
Optional
options: UserIdentitiesRevokeAccessToDeviceOptionsOptional
parameters: { Optional
email_Unique email address for the user identity.
Optional
full_Full name of the user associated with the user identity.
Optional
phone_Unique phone number for the user identity.
ID of the user identity that you want to update.
Optional
user_Unique key for the user identity.
Optional
options: UserIdentitiesUpdateOptionsOptional
parameters: { Optional
event_Types of events that you want the new webhook to receive.
URL for the new webhook.
Optional
options: WebhooksCreateOptionsOptional
parameters: { ID of the webhook that you want to delete.
Optional
options: WebhooksDeleteOptionsOptional
parameters: { ID of the webhook that you want to get.
Optional
options: WebhooksGetOptionsOptional
parameters: {}Optional
options: WebhooksListOptionsOptional
parameters: { Types of events that you want the webhook to receive.
ID of the webhook that you want to update.
Optional
options: WebhooksUpdateOptionsOptional
parameters: { Optional
company_Company name for the new workspace.
Optional
connect_Connect partner name for the new workspace.
Optional
connect_Connect Webview customizations for the new workspace. See also Customize the Look and Feel of Your Connect Webviews.
Optional
logo_Logo shape for Connect Webviews in the new workspace. See also Customize the Look and Feel of Your Connect Webviews.
Optional
primary_Primary button color for Connect Webviews in the new workspace. See also Customize the Look and Feel of Your Connect Webviews.
Optional
primary_Primary button text color for Connect Webviews in the new workspace. See also Customize the Look and Feel of Your Connect Webviews.
Optional
success_Success message for Connect Webviews in the new workspace. See also Customize the Look and Feel of Your Connect Webviews.
Optional
is_Indicates whether the new workspace is a sandbox workspace.
Name of the new workspace.
Optional
webview_Optional
webview_Optional
webview_Optional
webview_Optional
options: WorkspacesCreateOptionsOptional
parameters: {}Optional
options: WorkspacesGetOptionsOptional
parameters: {}Optional
options: WorkspacesListOptionsOptional
parameters: {}Optional
options: WorkspacesResetSandboxOptionsOptional
parameters: { Optional
connect_Connect partner name for the workspace.
Optional
connect_Connect Webview customizations for the workspace. See also Customize the Look and Feel of Your Connect Webviews.
Optional
logo_Logo shape for Connect Webviews in the workspace. See also Customize the Look and Feel of Your Connect Webviews.
Optional
primary_Primary button color for Connect Webviews in the workspace. See also Customize the Look and Feel of Your Connect Webviews.
Optional
primary_Primary button text color for Connect Webviews in the workspace. See also Customize the Look and Feel of Your Connect Webviews.
Optional
success_Success message for Connect Webviews in the workspace. See also Customize the Look and Feel of Your Connect Webviews.
Optional
is_Indicates whether the workspace is suspended.
Optional
name?: stringName of the workspace.
Optional
options: WorkspacesUpdateOptionsStatic
fromStatic
fromStatic
fromStatic
fromStatic
fromStatic
from
Indicates whether external modification of the code is allowed. Default:
false
.