Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -365,7 +365,7 @@ const access_code_error = z
replaced_by_newer_access_code,
])
.describe(
'Errors associated with the [access code](https://docs.seam.co/capability-guides/smart-locks/access-codes).',
'Errors associated with the [access code](https://docs.seam.co/latest/capability-guides/smart-locks/access-codes).',
)

export type AccessCodeError = z.infer<typeof access_code_error>
Expand Down Expand Up @@ -645,7 +645,7 @@ const access_code_warning = z
being_deleted,
])
.describe(
'Warnings associated with the [access code](https://docs.seam.co/capability-guides/smart-locks/access-codes).',
'Warnings associated with the [access code](https://docs.seam.co/latest/capability-guides/smart-locks/access-codes).',
)

export type AccessCodeWarning = z.infer<typeof access_code_warning>
Expand Down Expand Up @@ -814,7 +814,7 @@ export const access_code = z.object({
provider_metadata:
name: Provider Metadata
---
Errors associated with the [access code](https://docs.seam.co/capability-guides/smart-locks/access-codes).
Errors associated with the [access code](https://docs.seam.co/latest/capability-guides/smart-locks/access-codes).
`),
warnings: z.array(access_code_warning).describe(`
---
Expand All @@ -834,7 +834,7 @@ export const access_code = z.object({
provider_metadata:
name: Provider Metadata
---
Warnings associated with the [access code](https://docs.seam.co/capability-guides/smart-locks/access-codes).
Warnings associated with the [access code](https://docs.seam.co/latest/capability-guides/smart-locks/access-codes).
`),
is_managed: z
.literal(true)
Expand All @@ -858,7 +858,7 @@ export const access_code = z.object({
status: z
.enum(['setting', 'set', 'unset', 'removing', 'unknown'])
.describe(
'Current status of the access code within the operational lifecycle. Values are `setting`, a transitional phase that indicates that the code is being configured or activated; `set`, which indicates that the code is active and operational; `unset`, which indicates a deactivated or unused state, either before activation or after deliberate deactivation; `removing`, which indicates a transitional period in which the code is being deleted or made inactive; and `unknown`, which indicates an indeterminate state, due to reasons such as system errors or incomplete data, that highlights a potential need for system review or troubleshooting. See also [Lifecycle of Access Codes](https://docs.seam.co/capability-guides/smart-locks/access-codes/lifecycle-of-access-codes).',
'Current status of the access code within the operational lifecycle. Values are `setting`, a transitional phase that indicates that the code is being configured or activated; `set`, which indicates that the code is active and operational; `unset`, which indicates a deactivated or unused state, either before activation or after deliberate deactivation; `removing`, which indicates a transitional period in which the code is being deleted or made inactive; and `unknown`, which indicates an indeterminate state, due to reasons such as system errors or incomplete data, that highlights a potential need for system review or troubleshooting. See also [Lifecycle of Access Codes](https://docs.seam.co/latest/capability-guides/smart-locks/access-codes/lifecycle-of-access-codes).',
),
is_backup_access_code_available: z
.boolean()
Expand Down Expand Up @@ -907,13 +907,13 @@ export const access_code = z.object({
---
route_path: /access_codes
---
Represents a smart lock [access code](https://docs.seam.co/capability-guides/smart-locks/access-codes).
Represents a smart lock [access code](https://docs.seam.co/latest/capability-guides/smart-locks/access-codes).

An access code is a code used for a keypad or pinpad device. Unlike physical keys, which can easily be lost or duplicated, PIN codes can be customized, tracked, and altered on the fly. Using the Seam Access Code API, you can easily generate access codes on the hundreds of door lock models with which we integrate.

Seam supports programming two types of access codes: [ongoing](https://docs.seam.co/capability-guides/smart-locks/access-codes#ongoing-access-codes) and [time-bound](https://docs.seam.co/capability-guides/smart-locks/access-codes#time-bound-access-codes). To differentiate between the two, refer to the \`type\` property of the access code. Ongoing codes display as \`ongoing\`, whereas time-bound codes are labeled \`time_bound\`. An ongoing access code is active, until it has been removed from the device. To specify an ongoing access code, leave both \`starts_at\` and \`ends_at\` empty. A time-bound access code will be programmed at the \`starts_at\` time and removed at the \`ends_at\` time.
Seam supports programming two types of access codes: [ongoing](https://docs.seam.co/latest/capability-guides/smart-locks/access-codes#ongoing-access-codes) and [time-bound](https://docs.seam.co/latest/capability-guides/smart-locks/access-codes#time-bound-access-codes). To differentiate between the two, refer to the \`type\` property of the access code. Ongoing codes display as \`ongoing\`, whereas time-bound codes are labeled \`time_bound\`. An ongoing access code is active, until it has been removed from the device. To specify an ongoing access code, leave both \`starts_at\` and \`ends_at\` empty. A time-bound access code will be programmed at the \`starts_at\` time and removed at the \`ends_at\` time.

In addition, for certain devices, Seam also supports [offline access codes](https://docs.seam.co/capability-guides/smart-locks/access-codes#offline-access-codes). Offline access (PIN) codes are designed for door locks that might not always maintain an internet connection. For this type of access code, the device manufacturer uses encryption keys (tokens) to create server-based registries of algorithmically-generated offline PIN codes. Because the tokens remain synchronized with the managed devices, the locks do not require an active internet connection—and you do not need to be near the locks—to create an offline access code. Then, owners or managers can share these offline codes with users through a variety of mechanisms, such as messaging applications. That is, lock users do not need to install a smartphone application to receive an offline access code.
In addition, for certain devices, Seam also supports [offline access codes](https://docs.seam.co/latest/capability-guides/smart-locks/access-codes#offline-access-codes). Offline access (PIN) codes are designed for door locks that might not always maintain an internet connection. For this type of access code, the device manufacturer uses encryption keys (tokens) to create server-based registries of algorithmically-generated offline PIN codes. Because the tokens remain synchronized with the managed devices, the locks do not require an active internet connection—and you do not need to be near the locks—to create an offline access code. Then, owners or managers can share these offline codes with users through a variety of mechanisms, such as messaging applications. That is, lock users do not need to install a smartphone application to receive an offline access code.
`)

export type AccessCode = z.infer<typeof access_code>
Original file line number Diff line number Diff line change
Expand Up @@ -51,7 +51,7 @@ export const unmanaged_access_code = access_code
---
route_path: /access_codes/unmanaged
---
Represents an [unmanaged smart lock access code](https://docs.seam.co/capability-guides/smart-locks/access-codes/migrating-existing-access-codes).
Represents an [unmanaged smart lock access code](https://docs.seam.co/latest/capability-guides/smart-locks/access-codes/migrating-existing-access-codes).

An access code is a code used for a keypad or pinpad device. Unlike physical keys, which can easily be lost or duplicated, PIN codes can be customized, tracked, and altered on the fly.

Expand All @@ -61,7 +61,7 @@ export const unmanaged_access_code = access_code

Not all providers support unmanaged access codes. The following providers do not support unmanaged access codes:

- [Kwikset](https://docs.seam.co/device-and-system-integration-guides/kwikset-locks)
- [Kwikset](https://docs.seam.co/latest/device-and-system-integration-guides/kwikset-locks)
`)

export type UnmanagedAccessCode = z.infer<typeof unmanaged_access_code>
10 changes: 5 additions & 5 deletions src/lib/seam/connect/models/access-grants/access-grant.ts
Original file line number Diff line number Diff line change
Expand Up @@ -64,7 +64,7 @@ const being_deleted = common_access_grant_warning
warning_code: z.literal('being_deleted').describe(warning_code_description),
})
.describe(
'Indicates that the [access grant](https://docs.seam.co/capability-guides/access-grants) is being deleted.',
'Indicates that the [access grant](https://docs.seam.co/latest/capability-guides/access-grants) is being deleted.',
)

const underprovisioned_access = common_access_grant_warning
Expand Down Expand Up @@ -118,7 +118,7 @@ const updating_access_times = common_access_grant_warning
.describe('IDs of the access methods being updated.'),
})
.describe(
'Indicates that the access times for this [access grant](https://docs.seam.co/capability-guides/access-grants) are being updated.',
'Indicates that the access times for this [access grant](https://docs.seam.co/latest/capability-guides/access-grants) are being updated.',
)

const requested_code_unavailable = common_access_grant_warning
Expand Down Expand Up @@ -191,7 +191,7 @@ const access_grant_warning = z
device_time_constraints_violated,
])
.describe(
'Warning associated with the [access grant](https://docs.seam.co/capability-guides/access-grants).',
'Warning associated with the [access grant](https://docs.seam.co/latest/capability-guides/access-grants).',
)

const _access_grant_warning_map = z.object({
Expand Down Expand Up @@ -283,12 +283,12 @@ export const access_grant = z.object({
warnings: z
.array(access_grant_warning)
.describe(
'Warnings associated with the [access grant](https://docs.seam.co/capability-guides/access-grants).',
'Warnings associated with the [access grant](https://docs.seam.co/latest/capability-guides/access-grants).',
),
errors: z
.array(access_grant_error)
.describe(
'Errors associated with the [access grant](https://docs.seam.co/capability-guides/access-grants).',
'Errors associated with the [access grant](https://docs.seam.co/latest/capability-guides/access-grants).',
),
customization_profile_id: z
.string()
Expand Down
10 changes: 5 additions & 5 deletions src/lib/seam/connect/models/access-grants/access-method.ts
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ const being_deleted = common_access_method_warning
warning_code: z.literal('being_deleted').describe(warning_code_description),
})
.describe(
'Indicates that the [access method](https://docs.seam.co/capability-guides/access-grants/delivering-access-methods) is being deleted.',
'Indicates that the [access method](https://docs.seam.co/latest/capability-guides/access-grants/delivering-access-methods) is being deleted.',
)

const updating_access_times_warning = common_access_method_warning
Expand All @@ -30,7 +30,7 @@ const updating_access_times_warning = common_access_method_warning
.describe(warning_code_description),
})
.describe(
'Indicates that the access times for this [access method](https://docs.seam.co/capability-guides/access-grants/delivering-access-methods) are being updated.',
'Indicates that the access times for this [access method](https://docs.seam.co/latest/capability-guides/access-grants/delivering-access-methods) are being updated.',
)

const pulled_backup_access_code_warning = common_access_method_warning
Expand All @@ -57,7 +57,7 @@ const access_method_warning = z
pulled_backup_access_code_warning,
])
.describe(
'Warning associated with the [access method](https://docs.seam.co/capability-guides/access-grants/delivering-access-methods).',
'Warning associated with the [access method](https://docs.seam.co/latest/capability-guides/access-grants/delivering-access-methods).',
)

const _access_method_warning_map = z.object({
Expand Down Expand Up @@ -277,12 +277,12 @@ export const access_method = z.object({
warnings: z
.array(access_method_warning)
.describe(
'Warnings associated with the [access method](https://docs.seam.co/capability-guides/access-grants/delivering-access-methods).',
'Warnings associated with the [access method](https://docs.seam.co/latest/capability-guides/access-grants/delivering-access-methods).',
),
pending_mutations: z
.array(access_method_pending_mutations)
.describe(
'Pending mutations for the [access method](https://docs.seam.co/capability-guides/access-grants/delivering-access-methods). Indicates operations that are in progress.',
'Pending mutations for the [access method](https://docs.seam.co/latest/capability-guides/access-grants/delivering-access-methods). Indicates operations that are in progress.',
),
customization_profile_id: z
.string()
Expand Down
10 changes: 5 additions & 5 deletions src/lib/seam/connect/models/acs/acs-access-group.ts
Original file line number Diff line number Diff line change
Expand Up @@ -42,7 +42,7 @@ const acs_access_groups_failed_to_create_on_acs_system =
.describe(error_code_description),
})
.describe(
`Indicates that the [access group](https://docs.seam.co/capability-guides/access-systems/user-management/assigning-users-to-access-groups) was not created on the [access system](https://docs.seam.co/capability-guides/access-systems). This is likely due to an internal unexpected error. Contact Seam [support](mailto:support@seam.co).`,
`Indicates that the [access group](https://docs.seam.co/latest/capability-guides/access-systems/user-management/assigning-users-to-access-groups) was not created on the [access system](https://docs.seam.co/latest/capability-guides/access-systems). This is likely due to an internal unexpected error. Contact Seam [support](mailto:support@seam.co).`,
)

const acs_access_group_errors = z
Expand Down Expand Up @@ -119,13 +119,13 @@ const common_acs_access_group = z.object({
.string()
.uuid()
.describe(
'ID of the [workspace](https://docs.seam.co/core-concepts/workspaces) that contains the access group.',
'ID of the [workspace](https://docs.seam.co/latest/core-concepts/workspaces) that contains the access group.',
),
connected_account_id: z
.string()
.uuid()
.describe(
'ID of the [connected account](https://docs.seam.co/core-concepts/connected-accounts) that contains the access group.',
'ID of the [connected account](https://docs.seam.co/latest/core-concepts/connected-accounts) that contains the access group.',
),
name: z.string().describe('Name of the access group.'),
access_group_type: acs_access_group_external_type.describe(`
Expand Down Expand Up @@ -177,9 +177,9 @@ export const acs_access_group = common_acs_access_group.extend({
---
Group that defines the entrances to which a set of users has access and, in some cases, the access schedule for these entrances and users.

Some access control systems use [access group](https://docs.seam.co/capability-guides/access-systems/user-management/assigning-users-to-access-groups), which are sets of users, combined with sets of permissions. These permissions include both the set of areas or assets that the users can access and the schedule during which the users can access these areas or assets. Instead of assigning access rights individually to each access control system user, which can be time-consuming and error-prone, administrators can assign users to an access group, thereby ensuring that the users inherit all the permissions associated with the access group. Using access groups streamlines the process of managing large numbers of access control system users, especially in bigger organizations or complexes.
Some access control systems use [access group](https://docs.seam.co/latest/capability-guides/access-systems/user-management/assigning-users-to-access-groups), which are sets of users, combined with sets of permissions. These permissions include both the set of areas or assets that the users can access and the schedule during which the users can access these areas or assets. Instead of assigning access rights individually to each access control system user, which can be time-consuming and error-prone, administrators can assign users to an access group, thereby ensuring that the users inherit all the permissions associated with the access group. Using access groups streamlines the process of managing large numbers of access control system users, especially in bigger organizations or complexes.

To learn whether your access control system supports access groups, see the corresponding [system integration guide](https://docs.seam.co/device-and-system-integration-guides#access-control-systems).
To learn whether your access control system supports access groups, see the corresponding [system integration guide](https://docs.seam.co/latest/device-and-system-integration-guides#access-control-systems).
`)
export const unmanaged_acs_access_group = common_acs_access_group.extend({
is_managed: z.literal(false),
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -23,13 +23,13 @@ export const enrollment_automation = z.object({
.string()
.uuid()
.describe(
'ID of the associated [ACS system](https://docs.seam.co/capability-guides/access-systems) that serves as the credential manager.',
'ID of the associated [ACS system](https://docs.seam.co/latest/capability-guides/access-systems) that serves as the credential manager.',
),
user_identity_id: z
.string()
.uuid()
.describe(
'ID of the associated [user identity](https://docs.seam.co/capability-guides/mobile-access/managing-mobile-app-user-accounts-with-user-identities#what-is-a-user-identity).',
'ID of the associated [user identity](https://docs.seam.co/latest/capability-guides/mobile-access/managing-mobile-app-user-accounts-with-user-identities#what-is-a-user-identity).',
),
created_at: z
.string()
Expand All @@ -39,14 +39,14 @@ export const enrollment_automation = z.object({
.string()
.uuid()
.describe(
'ID of the [workspace](https://docs.seam.co/core-concepts/workspaces) that contains the enrollment automation.',
'ID of the [workspace](https://docs.seam.co/latest/core-concepts/workspaces) that contains the enrollment automation.',
),
}).describe(`
---
route_path: /user_identities/enrollment_automations
undocumented: Will be removed.
---
Represents an [enrollment automation](https://docs.seam.co/capability-guides/mobile-access/issuing-mobile-credentials-from-an-access-control-system) within the [Seam mobile access solution](https://docs.seam.co/capability-guides/mobile-access/).
Represents an [enrollment automation](https://docs.seam.co/latest/capability-guides/mobile-access/issuing-mobile-credentials-from-an-access-control-system) within the [Seam mobile access solution](https://docs.seam.co/latest/capability-guides/mobile-access/).
`)

export type EnrollmentAutomation = z.output<typeof enrollment_automation>
Expand Down
Loading
Loading