@seamapi/types 1.359.0 → 1.360.1

package/lib/seam/connect/openapi.js

@@ -943,31 +943,31 @@ export default {
                 'x-route-path': '/acs/access_groups',
             },
             acs_credential: {
-                description: 'Means by which a user gains access at an entrance. The `acs_credential` object represents a credential that provides an ACS user access within an access control system. For each acs_credential object, you define the access method. You can also specify additional properties, such as a code.',
+                description: 'Means by which an [ACS user](https://docs.seam.co/latest/capability-guides/access-systems/user-management) gains access at an [entrance](https://docs.seam.co/latest/capability-guides/access-systems/retrieving-entrance-details). The `acs_credential` object represents a [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) that provides an ACS user access within an [access control system](https://docs.seam.co/latest/capability-guides/access-systems). For each `acs_credential` object, you define the access method. You can also specify additional properties, such as a PIN code.',
                 properties: {
                     access_method: {
-                        description: 'Access method for the credential. Supported values: `code`, `card`, `mobile_key`.',
+                        description: 'Access method for the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials). Supported values: `code`, `card`, `mobile_key`.',
                         enum: ['code', 'card', 'mobile_key'],
                         type: 'string',
                     },
                     acs_credential_id: {
-                        description: 'ID of the credential.',
+                        description: 'ID of the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials).',
                         format: 'uuid',
                         type: 'string',
                     },
                     acs_credential_pool_id: { format: 'uuid', type: 'string' },
                     acs_system_id: {
-                        description: 'ID of the access control system that contains the credential.',
+                        description: 'ID of the [access control system](https://docs.seam.co/latest/capability-guides/access-systems) that contains the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials).',
                         format: 'uuid',
                         type: 'string',
                     },
                     acs_user_id: {
-                        description: 'ID of the ACS user to whom the credential belongs.',
+                        description: 'ID of the [ACS user](https://docs.seam.co/latest/capability-guides/access-systems/user-management) to whom the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) belongs.',
                         format: 'uuid',
                         type: 'string',
                     },
                     assa_abloy_vostio_metadata: {
-                        description: 'Vostio-specific metadata for the credential.',
+                        description: 'Vostio-specific metadata for the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials).',
                         properties: {
                             door_names: { items: { type: 'string' }, type: 'array' },
                             endpoint_id: { type: 'string' },
@@ -980,28 +980,32 @@ export default {
                         },
                         type: 'object',
                     },
-                    card_number: { nullable: true, type: 'string' },
+                    card_number: {
+                        description: 'Number of the card associated with the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials).',
+                        nullable: true,
+                        type: 'string',
+                    },
                     code: {
-                        description: 'Access (PIN) code for the credential.',
+                        description: 'Access (PIN) code for the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials).',
                         nullable: true,
                         type: 'string',
                     },
                     created_at: {
-                        description: 'Date and time at which the credential was created.',
+                        description: 'Date and time at which the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) was created.',
                         format: 'date-time',
                         type: 'string',
                     },
                     display_name: {
-                        description: 'Display name that corresponds to the credential type.',
+                        description: 'Display name that corresponds to the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) type.',
                         minLength: 1,
                         type: 'string',
                     },
                     ends_at: {
-                        description: 'Date and time at which the credential validity ends, in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format. Must be a time in the future and after `starts_at`.',
+                        description: 'Date and time at which the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) validity ends, in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format. Must be a time in the future and after `starts_at`.',
                         type: 'string',
                     },
                     errors: {
-                        description: 'Errors associated with the `acs_credential`.',
+                        description: 'Errors associated with the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials).',
                         items: {
                             properties: {
                                 error_code: { type: 'string' },
@@ -1013,7 +1017,7 @@ export default {
                         type: 'array',
                     },
                     external_type: {
-                        description: 'Brand-specific terminology for the credential type. Supported values: `pti_card`, `brivo_credential`, `hid_credential`, `visionline_card`.',
+                        description: 'Brand-specific terminology for the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) type. Supported values: `pti_card`, `brivo_credential`, `hid_credential`, `visionline_card`.',
                         enum: [
                             'pti_card',
                             'brivo_credential',
@@ -1026,42 +1030,50 @@ export default {
                         type: 'string',
                     },
                     external_type_display_name: {
-                        description: 'Display name that corresponds to the brand-specific terminology for the credential type.',
+                        description: 'Display name that corresponds to the brand-specific terminology for the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) type.',
                         type: 'string',
                     },
-                    is_issued: { type: 'boolean' },
+                    is_issued: {
+                        description: 'Indicates whether the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) has been encoded onto a card.',
+                        type: 'boolean',
+                    },
                     is_latest_desired_state_synced_with_provider: {
-                        description: 'Indicates whether the latest state of the credential has been synced from Seam to the provider.',
+                        description: 'Indicates whether the latest state of the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) has been synced from Seam to the provider.',
                         nullable: true,
                         type: 'boolean',
                     },
                     is_managed: { enum: [true], type: 'boolean' },
                     is_multi_phone_sync_credential: {
-                        description: 'Indicates whether the credential is a [multi-phone sync credential](https://docs.seam.co/latest/capability-guides/mobile-access-in-development/issuing-mobile-credentials-from-an-access-control-system#what-are-multi-phone-sync-credentials).',
+                        description: 'Indicates whether the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) is a [multi-phone sync credential](https://docs.seam.co/latest/capability-guides/mobile-access-in-development/issuing-mobile-credentials-from-an-access-control-system#what-are-multi-phone-sync-credentials).',
                         type: 'boolean',
                     },
                     is_one_time_use: {
-                        description: 'Indicates whether the credential can only be used once. If "true," the code becomes invalid after the first use.',
+                        description: 'Indicates whether the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) can only be used once. If `true`, the code becomes invalid after the first use.',
                         type: 'boolean',
                     },
-                    issued_at: { format: 'date-time', nullable: true, type: 'string' },
+                    issued_at: {
+                        description: 'Date and time at which the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) was encoded onto a card.',
+                        format: 'date-time',
+                        nullable: true,
+                        type: 'string',
+                    },
                     latest_desired_state_synced_with_provider_at: {
-                        description: 'Date and time at which the state of the credential was most recently synced from Seam to the provider.',
+                        description: 'Date and time at which the state of the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) was most recently synced from Seam to the provider.',
                         format: 'date-time',
                         nullable: true,
                         type: 'string',
                     },
                     parent_acs_credential_id: {
-                        description: 'ID of the parent credential.',
+                        description: 'ID of the parent [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials).',
                         format: 'uuid',
                         type: 'string',
                     },
                     starts_at: {
-                        description: 'Date and time at which the credential validity starts, in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format.',
+                        description: 'Date and time at which the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) validity starts, in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format.',
                         type: 'string',
                     },
                     visionline_metadata: {
-                        description: 'Visionline-specific metadata for the credential.',
+                        description: 'Visionline-specific metadata for the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials).',
                         properties: {
                             auto_join: { type: 'boolean' },
                             card_function_type: { enum: ['guest', 'staff'], type: 'string' },
@@ -1085,13 +1097,13 @@ export default {
                         type: 'object',
                     },
                     warnings: {
-                        description: 'Warnings associated with the `acs_credential`.',
+                        description: 'Warnings associated with the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials).',
                         items: {
-                            description: 'Warning associated with the `acs_credential`.',
+                            description: 'Warning associated with the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials).',
                             discriminator: { propertyName: 'warning_code' },
                             oneOf: [
                                 {
-                                    description: 'Indicates that the credential is waiting to be issued.',
+                                    description: 'Indicates that the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) is waiting to be issued.',
                                     properties: {
                                         created_at: {
                                             description: 'Date and time at which Seam created the warning.',
@@ -1112,7 +1124,7 @@ export default {
                                     type: 'object',
                                 },
                                 {
-                                    description: "Indicates that the schedule of one of the credential's children was modified externally.",
+                                    description: "Indicates that the schedule of one of the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials)'s children was modified externally.",
                                     properties: {
                                         created_at: {
                                             description: 'Date and time at which Seam created the warning.',
@@ -1133,7 +1145,7 @@ export default {
                                     type: 'object',
                                 },
                                 {
-                                    description: 'Indicates that the schedule of this credential was modified to avoid creating a credential with a start date in the past.',
+                                    description: 'Indicates that the schedule of the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) was modified to avoid creating a credential with a start date in the past.',
                                     properties: {
                                         created_at: {
                                             description: 'Date and time at which Seam created the warning.',
@@ -1154,7 +1166,7 @@ export default {
                                     type: 'object',
                                 },
                                 {
-                                    description: 'Indicates that this credential is being deleted.',
+                                    description: 'Indicates that the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) is being deleted.',
                                     properties: {
                                         created_at: {
                                             description: 'Date and time at which Seam created the warning.',
@@ -1175,7 +1187,7 @@ export default {
                                     type: 'object',
                                 },
                                 {
-                                    description: 'An unknown issue occurred while syncing the state of this credential with the provider. This issue may affect the proper functioning of this credential.',
+                                    description: 'An unknown issue occurred while syncing the state of the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) with the provider. This issue may affect the proper functioning of the credential.',
                                     properties: {
                                         created_at: {
                                             description: 'Date and time at which Seam created the warning.',
@@ -1196,7 +1208,7 @@ export default {
                                     type: 'object',
                                 },
                                 {
-                                    description: 'Access permissions for this [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) have changed. [Reissue](https://docs.seam.co/latest/capability-guides/access-systems/working-with-card-encoders-and-scanners/creating-and-encoding-card-based-credentials) (re-encode) this credential. This issue may affect the proper functioning of the credential.',
+                                    description: 'Access permissions for the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) have changed. [Reissue](https://docs.seam.co/latest/capability-guides/access-systems/working-with-card-encoders-and-scanners/creating-and-encoding-card-based-credentials) (re-encode) the credential. This issue may affect the proper functioning of the credential.',
                                     properties: {
                                         created_at: {
                                             description: 'Date and time at which Seam created the warning.',
@@ -1221,7 +1233,7 @@ export default {
                         type: 'array',
                     },
                     workspace_id: {
-                        description: 'ID of the [workspace](https://docs.seam.co/latest/core-concepts/workspaces) that contains the credential.',
+                        description: 'ID of the [workspace](https://docs.seam.co/latest/core-concepts/workspaces) that contains the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials).',
                         format: 'uuid',
                         type: 'string',
                     },
@@ -1287,28 +1299,28 @@ export default {
                 description: 'Represents a hardware device that encodes [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) data onto physical cards within an [access control system](https://docs.seam.co/latest/capability-guides/access-systems). See also [Working with Card Encoders and Scanners](https://docs.seam.co/latest/capability-guides/access-systems/working-with-card-encoders-and-scanners).',
                 properties: {
                     acs_encoder_id: {
-                        description: 'ID of the `acs_encoder`.',
+                        description: 'ID of the [encoder](https://docs.seam.co/latest/capability-guides/access-systems/working-with-card-encoders-and-scanners.',
                         format: 'uuid',
                         type: 'string',
                     },
                     acs_system_id: {
-                        description: 'ID of the access control system that contains the `acs_encoder`.',
+                        description: 'ID of the [access control system](https://docs.seam.co/latest/capability-guides/access-systems) that contains the [encoder](https://docs.seam.co/latest/capability-guides/access-systems/working-with-card-encoders-and-scanners).',
                         format: 'uuid',
                         type: 'string',
                     },
                     created_at: {
-                        description: 'Date and time at which the `acs_encoder` was created.',
+                        description: 'Date and time at which the [encoder](https://docs.seam.co/latest/capability-guides/access-systems/working-with-card-encoders-and-scanners) was created.',
                         format: 'date-time',
                         type: 'string',
                     },
                     display_name: {
-                        description: 'Display name for the `acs_encoder`.',
+                        description: 'Display name for the [encoder](https://docs.seam.co/latest/capability-guides/access-systems/working-with-card-encoders-and-scanners).',
                         type: 'string',
                     },
                     errors: {
-                        description: 'Errors associated with the `acs_encoder`.',
+                        description: 'Errors associated with the [encoder](https://docs.seam.co/latest/capability-guides/access-systems/working-with-card-encoders-and-scanners).',
                         items: {
-                            description: 'Error associated with the `acs_encoder`.',
+                            description: 'Error associated with the [encoder](https://docs.seam.co/latest/capability-guides/access-systems/working-with-card-encoders-and-scanners).',
                             properties: {
                                 created_at: {
                                     description: 'Date and time at which Seam created the error.',
@@ -1331,7 +1343,7 @@ export default {
                         type: 'array',
                     },
                     workspace_id: {
-                        description: 'ID of the [workspace](https://docs.seam.co/latest/core-concepts/workspaces) that contains the `acs_system`.',
+                        description: 'ID of the [workspace](https://docs.seam.co/latest/core-concepts/workspaces) that contains the [encoder](https://docs.seam.co/latest/capability-guides/access-systems/working-with-card-encoders-and-scanners).',
                         format: 'uuid',
                         type: 'string',
                     },
@@ -1351,16 +1363,17 @@ export default {
                 description: 'Represents an [entrance](https://docs.seam.co/latest/capability-guides/access-systems/retrieving-entrance-details) within an [access control system](https://docs.seam.co/latest/capability-guides/access-systems).',
                 properties: {
                     acs_entrance_id: {
-                        description: 'ID of the entrance.',
+                        description: 'ID of the [entrance](https://docs.seam.co/latest/capability-guides/access-systems/retrieving-entrance-details).',
                         format: 'uuid',
                         type: 'string',
                     },
                     acs_system_id: {
-                        description: 'ID of the access control system that contains the entrance.',
+                        description: 'ID of the [access control system](https://docs.seam.co/latest/capability-guides/access-systems) that contains the [entrance](https://docs.seam.co/latest/capability-guides/access-systems/retrieving-entrance-details).',
                         format: 'uuid',
                         type: 'string',
                     },
                     assa_abloy_vostio_metadata: {
+                        description: 'ASSA ABLOY Vostio-specific metadata associated with the [entrance](https://docs.seam.co/latest/capability-guides/access-systems/retrieving-entrance-details).',
                         properties: {
                             door_name: { type: 'string' },
                             door_number: { format: 'float', type: 'number' },
@@ -1375,24 +1388,32 @@ export default {
                         type: 'object',
                     },
                     created_at: {
-                        description: 'Date and time at which the entrance was created.',
+                        description: 'Date and time at which the [entrance](https://docs.seam.co/latest/capability-guides/access-systems/retrieving-entrance-details) was created.',
                         format: 'date-time',
                         type: 'string',
                     },
                     display_name: {
-                        description: 'Display name for the entrance.',
+                        description: 'Display name for the [entrance](https://docs.seam.co/latest/capability-guides/access-systems/retrieving-entrance-details).',
                         type: 'string',
                     },
                     dormakaba_community_metadata: {
+                        description: 'dormakaba Community-specific metadata associated with the [entrance](https://docs.seam.co/latest/capability-guides/access-systems/retrieving-entrance-details).',
                         properties: { access_point_name: { type: 'string' } },
                         required: ['access_point_name'],
                         type: 'object',
                     },
                     errors: {
+                        description: 'Errors associated with the [entrance](https://docs.seam.co/latest/capability-guides/access-systems/retrieving-entrance-details).',
                         items: {
                             properties: {
-                                error_code: { type: 'string' },
-                                message: { type: 'string' },
+                                error_code: {
+                                    description: 'Unique identifier of the type of error. Enables quick recognition and categorization of the issue.',
+                                    type: 'string',
+                                },
+                                message: {
+                                    description: 'Detailed description of the error. Provides insights into the issue and potentially how to rectify it.',
+                                    type: 'string',
+                                },
                             },
                             required: ['error_code', 'message'],
                             type: 'object',
@@ -1400,6 +1421,7 @@ export default {
                         type: 'array',
                     },
                     latch_metadata: {
+                        description: 'Latch-specific metadata associated with the [entrance](https://docs.seam.co/latest/capability-guides/access-systems/retrieving-entrance-details).',
                         properties: {
                             accessibility_type: { type: 'string' },
                             door_name: { type: 'string' },
@@ -1415,6 +1437,7 @@ export default {
                         type: 'object',
                     },
                     salto_ks_metadata: {
+                        description: 'Salto KS-specific metadata associated with the [entrance](https://docs.seam.co/latest/capability-guides/access-systems/retrieving-entrance-details).',
                         properties: {
                             battery_level: { type: 'string' },
                             door_name: { type: 'string' },
@@ -1434,6 +1457,7 @@ export default {
                         type: 'object',
                     },
                     salto_space_metadata: {
+                        description: 'Salto Space-specific metadata associated with the [entrance](https://docs.seam.co/latest/capability-guides/access-systems/retrieving-entrance-details).',
                         properties: {
                             door_description: { type: 'string' },
                             door_name: { type: 'string' },
@@ -1443,6 +1467,7 @@ export default {
                         type: 'object',
                     },
                     visionline_metadata: {
+                        description: 'Visionline-specific metadata associated with the [entrance](https://docs.seam.co/latest/capability-guides/access-systems/retrieving-entrance-details).',
                         properties: {
                             door_category: {
                                 enum: [
@@ -1491,58 +1516,57 @@ export default {
                 description: 'Represents an [access control system](https://docs.seam.co/latest/capability-guides/access-systems).',
                 properties: {
                     acs_system_id: {
-                        description: 'ID of the `acs_system`.',
+                        description: 'ID of the [access control system](https://docs.seam.co/latest/capability-guides/access-systems).',
                         format: 'uuid',
                         type: 'string',
                     },
                     can_add_acs_users_to_acs_access_groups: {
-                        description: 'Indicates whether the `acs_system` supports [adding users to access groups](https://docs.seam.co/latest/capability-guides/access-systems/assigning-users-to-access-groups#add-an-acs-user-to-an-access-group). See also [Access Group-based Access Control Systems](https://docs.seam.co/latest/capability-guides/access-systems/understanding-access-control-system-differences#access-group-based-access-control-systems).',
+                        description: 'Indicates whether the [access control system](https://docs.seam.co/latest/capability-guides/access-systems) supports [adding users to access groups](https://docs.seam.co/latest/capability-guides/access-systems/assigning-users-to-access-groups#add-an-acs-user-to-an-access-group). See also [Access Group-based Access Control Systems](https://docs.seam.co/latest/capability-guides/access-systems/understanding-access-control-system-differences#access-group-based-access-control-systems).',
                         type: 'boolean',
                     },
                     can_automate_enrollment: {
-                        description: 'Indicates whether it is possible to [launch enrollment automations](https://docs.seam.co/latest/capability-guides/mobile-access-in-development/issuing-mobile-credentials-from-an-access-control-system#prepare-the-phones-for-a-user-identity-to-start-receiving-mobile-credentials-using-an-enrollment-aut) for the `acs_system`.',
+                        description: 'Indicates whether it is possible to [launch enrollment automations](https://docs.seam.co/latest/capability-guides/mobile-access/issuing-mobile-credentials-from-an-access-control-system#prepare-the-phones-for-a-user-identity-to-start-receiving-mobile-credentials-using-an-enrollment-aut) for the [access control system](https://docs.seam.co/latest/capability-guides/access-systems).',
                         type: 'boolean',
                     },
                     can_create_acs_access_groups: {
-                        description: 'Indicates whether the `acs_system` supports creating [access groups](https://docs.seam.co/latest/capability-guides/access-systems/assigning-users-to-access-groups). See also [Access Group-based Access Control Systems](https://docs.seam.co/latest/capability-guides/access-systems/understanding-access-control-system-differences#access-group-based-access-control-systems).',
+                        description: 'Indicates whether the [access control system](https://docs.seam.co/latest/capability-guides/access-systems) supports creating [access groups](https://docs.seam.co/latest/capability-guides/access-systems/assigning-users-to-access-groups). See also [Access Group-based Access Control Systems](https://docs.seam.co/latest/capability-guides/access-systems/understanding-access-control-system-differences#access-group-based-access-control-systems).',
                         type: 'boolean',
                     },
                     can_remove_acs_users_from_acs_access_groups: {
-                        description: 'Indicates whether the `acs_system` supports [removing users from access groups](https://docs.seam.co/latest/capability-guides/access-systems/assigning-users-to-access-groups#remove-an-acs-user-from-an-access-group). See also [Access Group-based Access Control Systems](https://docs.seam.co/latest/capability-guides/access-systems/understanding-access-control-system-differences#access-group-based-access-control-systems).',
+                        description: 'Indicates whether the [access control system](https://docs.seam.co/latest/capability-guides/access-systems) supports [removing users from access groups](https://docs.seam.co/latest/capability-guides/access-systems/assigning-users-to-access-groups#remove-an-acs-user-from-an-access-group). See also [Access Group-based Access Control Systems](https://docs.seam.co/latest/capability-guides/access-systems/understanding-access-control-system-differences#access-group-based-access-control-systems).',
                         type: 'boolean',
                     },
                     connected_account_id: {
-                        description: 'ID of the [connected account](https://docs.seam.co/latest/core-concepts/connected-accounts) associated with the `acs_system`.',
+                        description: 'ID of the [connected account](https://docs.seam.co/latest/core-concepts/connected-accounts) associated with the [access control system](https://docs.seam.co/latest/capability-guides/access-systems).',
                         format: 'uuid',
                         type: 'string',
                     },
                     connected_account_ids: {
                         deprecated: true,
-                        description: 'IDs of the [connected accounts](https://docs.seam.co/latest/core-concepts/connected-accounts) associated with the `acs_system`.',
+                        description: 'IDs of the [connected accounts](https://docs.seam.co/latest/core-concepts/connected-accounts) associated with the [access control system](https://docs.seam.co/latest/capability-guides/access-systems).',
                         items: { format: 'uuid', type: 'string' },
                         type: 'array',
                         'x-deprecated': 'Use `connected_account_id`.',
                     },
                     created_at: {
-                        description: 'Date and time at which the `acs_system` was created.',
+                        description: 'Date and time at which the [access control system](https://docs.seam.co/latest/capability-guides/access-systems) was created.',
                         format: 'date-time',
                         type: 'string',
                     },
                     default_credential_manager_acs_system_id: {
-                        description: 'ID of the default credential manager acs_system for this access control system.',
+                        description: 'ID of the default credential manager `acs_system` for this [access control system](https://docs.seam.co/latest/capability-guides/access-systems).',
                         format: 'uuid',
                         nullable: true,
                         type: 'string',
-                        'x-draft': 'Needs review',
                     },
                     errors: {
-                        description: 'Errors associated with the `acs_system`.',
+                        description: 'Errors associated with the [access control system](https://docs.seam.co/latest/capability-guides/access-systems).',
                         items: {
-                            description: 'Error associated with the `acs_system`.',
+                            description: 'Error associated with the [access control system](https://docs.seam.co/latest/capability-guides/access-systems).',
                             discriminator: { propertyName: 'error_code' },
                             oneOf: [
                                 {
-                                    description: 'Indicates that the Seam API cannot communicate with the [Seam Bridge](https://docs.seam.co/latest/capability-guides/seam-bridge), for example, if the Seam Bridge executable has stopped or if the computer running the Seam Bridge executable is offline.\n  This error might also occur if the Seam Bridge is connected to the wrong [workspace](https://docs.seam.co/latest/core-concepts/workspaces).\n  See also [Troubleshooting Your Access Control System](https://docs.seam.co/latest/capability-guides/capability-guides/access-systems/troubleshooting-your-access-control-system#acs_system.errors.seam_bridge_disconnected).',
+                                    description: 'Indicates that the Seam API cannot communicate with [Seam Bridge](https://docs.seam.co/latest/capability-guides/seam-bridge), for example, if Seam Bridge executable has stopped or if the computer running the Seam Bridge executable is offline.\n  This error might also occur if Seam Bridge is connected to the wrong [workspace](https://docs.seam.co/latest/core-concepts/workspaces).\n  See also [Troubleshooting Your Access Control System](https://docs.seam.co/latest/capability-guides/capability-guides/access-systems/troubleshooting-your-access-control-system#acs_system.errors.seam_bridge_disconnected).',
                                     properties: {
                                         created_at: {
                                             description: 'Date and time at which Seam created the error.',
@@ -1563,7 +1587,7 @@ export default {
                                     type: 'object',
                                 },
                                 {
-                                    description: 'Indicates that the Seam Bridge is functioning correctly and the Seam API can communicate with the Seam Bridge, but the Seam API cannot connect to the on-premises [Visionline access control system](https://docs.seam.co/latest/device-and-system-integration-guides/assa-abloy-visionline-access-control-system).\n  For example, the IP address of the on-premises access control system may be set incorrectly within the Seam [workspace](https://docs.seam.co/latest/core-concepts/workspaces).\n  See also [Troubleshooting Your Access Control System](https://docs.seam.co/latest/capability-guides/capability-guides/access-systems/troubleshooting-your-access-control-system#acs_system.errors.visionline_instance_unreachable).',
+                                    description: 'Indicates that [Seam Bridge](https://docs.seam.co/latest/capability-guides/seam-bridge) is functioning correctly and the Seam API can communicate with Seam Bridge, but the Seam API cannot connect to the on-premises [Visionline access control system](https://docs.seam.co/latest/device-and-system-integration-guides/assa-abloy-visionline-access-control-system).\n  For example, the IP address of the on-premises access control system may be set incorrectly within the Seam [workspace](https://docs.seam.co/latest/core-concepts/workspaces).\n  See also [Troubleshooting Your Access Control System](https://docs.seam.co/latest/capability-guides/capability-guides/access-systems/troubleshooting-your-access-control-system#acs_system.errors.visionline_instance_unreachable).',
                                     properties: {
                                         created_at: {
                                             description: 'Date and time at which Seam created the error.',
@@ -1605,7 +1629,7 @@ export default {
                                     type: 'object',
                                 },
                                 {
-                                    description: 'Indicates that the access system has been disconnected. See [this guide](https://docs.seam.co/latest/capability-guides/access-systems/troubleshooting-your-access-control-system guide) to resolve the issue.',
+                                    description: 'Indicates that the [access control system](https://docs.seam.co/latest/capability-guides/access-systems) has been disconnected. See [Troubleshooting Your Access Control System](https://docs.seam.co/latest/capability-guides/access-systems/troubleshooting-your-access-control-system) to resolve the issue.',
                                     properties: {
                                         created_at: {
                                             description: 'Date and time at which Seam created the error.',
@@ -1626,7 +1650,7 @@ export default {
                                     type: 'object',
                                 },
                                 {
-                                    description: 'Indicates that the login credentials are invalid. Reconnect the account using the Connect Webview to restore access.',
+                                    description: 'Indicates that the login credentials are invalid. Reconnect the account using a [Connect Webview](https://docs.seam.co/latest/ui-components/connect-webviews) to restore access.',
                                     properties: {
                                         created_at: {
                                             description: 'Date and time at which Seam created the error.',
@@ -1647,6 +1671,7 @@ export default {
                                     type: 'object',
                                 },
                                 {
+                                    description: 'Indicates that the [access control system](https://docs.seam.co/latest/capability-guides/access-systems) has lost its Salto KS certification. Contact [support](mailto:support@seam.co) to regain access.',
                                     properties: {
                                         created_at: {
                                             description: 'Date and time at which Seam created the error.',
@@ -1654,7 +1679,7 @@ export default {
                                             type: 'string',
                                         },
                                         error_code: {
-                                            description: 'Indicates that the access system has lost its Salto KS certification. Please contact support to regain access.',
+                                            description: 'Unique identifier of the type of error. Enables quick recognition and categorization of the issue.',
                                             enum: ['salto_ks_certification_expired'],
                                             type: 'string',
                                         },
@@ -1671,7 +1696,7 @@ export default {
                         type: 'array',
                     },
                     external_type: {
-                        description: 'Brand-specific terminology for the `acs_system` type.',
+                        description: 'Brand-specific terminology for the [access control system](https://docs.seam.co/latest/capability-guides/access-systems) type.',
                         enum: [
                             'pti_site',
                             'alta_org',
@@ -1690,25 +1715,25 @@ export default {
                         type: 'string',
                     },
                     external_type_display_name: {
-                        description: 'Display name that corresponds to the brand-specific terminology for the `acs_system` type.',
+                        description: 'Display name that corresponds to the brand-specific terminology for the [access control system](https://docs.seam.co/latest/capability-guides/access-systems) type.',
                         type: 'string',
                     },
                     image_alt_text: {
-                        description: 'Alternative text for the `acs_system` image.',
+                        description: 'Alternative text for the [access control system](https://docs.seam.co/latest/capability-guides/access-systems) image.',
                         type: 'string',
                     },
                     image_url: {
-                        description: 'URL for the image that represents the `acs_system`.',
+                        description: 'URL for the image that represents the [access control system](https://docs.seam.co/latest/capability-guides/access-systems).',
                         type: 'string',
                     },
                     is_credential_manager: {
-                        description: 'Indicates if the `acs_system` is a credential manager.',
+                        description: 'Indicates whether the `acs_system` is a credential manager.',
                         type: 'boolean',
                     },
                     location: {
                         properties: {
                             time_zone: {
-                                description: 'Time zone in which the `acs_system` is located.',
+                                description: 'Time zone in which the [access control system](https://docs.seam.co/latest/capability-guides/access-systems) is located.',
                                 nullable: true,
                                 type: 'string',
                             },
@@ -1716,7 +1741,10 @@ export default {
                         required: ['time_zone'],
                         type: 'object',
                     },
-                    name: { description: 'Name of the `acs_system`.', type: 'string' },
+                    name: {
+                        description: 'Name of the [access control system](https://docs.seam.co/latest/capability-guides/access-systems).',
+                        type: 'string',
+                    },
                     system_type: {
                         deprecated: true,
                         enum: [
@@ -1745,7 +1773,7 @@ export default {
                     visionline_metadata: {
                         properties: {
                             lan_address: {
-                                description: 'IP address or hostname of the main Visionline server relative to the Seam Bridge on the local network.',
+                                description: 'IP address or hostname of the main Visionline server relative to [Seam Bridge](https://docs.seam.co/latest/capability-guides/seam-bridge) on the local network.',
                                 type: 'string',
                             },
                             mobile_access_uuid: {
@@ -1761,12 +1789,13 @@ export default {
                         type: 'object',
                     },
                     warnings: {
-                        description: 'Warnings associated with the `acs_system`.',
+                        description: 'Warnings associated with the [access control system](https://docs.seam.co/latest/capability-guides/access-systems).',
                         items: {
-                            description: 'Warning associated with the `acs_system`.',
+                            description: 'Warning associated with the [access control system](https://docs.seam.co/latest/capability-guides/access-systems).',
                             discriminator: { propertyName: 'warning_code' },
                             oneOf: [
                                 {
+                                    description: 'Indicates that the Salto KS site has exceeded 80% of the maximum number of allowed users. Increase your subscription limit or delete some users from your site to rectify the issue.',
                                     properties: {
                                         created_at: {
                                             description: 'Date and time at which Seam created the warning.',
@@ -1778,7 +1807,7 @@ export default {
                                             type: 'string',
                                         },
                                         warning_code: {
-                                            description: 'Indicates that the Salto KS site has exceeded 80% of the maximum number of allowed users. Please increase your subscription limit, or delete some users from your site to rectify this.',
+                                            description: 'Unique identifier of the type of warning. Enables quick recognition and categorization of the issue.',
                                             enum: ['salto_ks_subscription_limit_almost_reached'],
                                             type: 'string',
                                         },
@@ -1787,6 +1816,7 @@ export default {
                                     type: 'object',
                                 },
                                 {
+                                    description: 'Indicates the [access control system](https://docs.seam.co/latest/capability-guides/access-systems) time zone could not be determined because the reported physical location does not match the time zone configured on the physical [ACS entrances](https://docs.seam.co/latest/capability-guides/access-systems/retrieving-entrance-details).',
                                     properties: {
                                         created_at: {
                                             description: 'Date and time at which Seam created the warning.',
@@ -1802,7 +1832,7 @@ export default {
                                             type: 'array',
                                         },
                                         warning_code: {
-                                            description: 'Indicates the ACS system time zone could not be determined because the reported physical location does not match the time zone configured on the physical ACS entrances.',
+                                            description: 'Unique identifier of the type of warning. Enables quick recognition and categorization of the issue.',
                                             enum: ['time_zone_does_not_match_location'],
                                             type: 'string',
                                         },
@@ -1815,7 +1845,7 @@ export default {
                         type: 'array',
                     },
                     workspace_id: {
-                        description: 'ID of the [workspace](https://docs.seam.co/latest/core-concepts/workspaces) that contains the `acs_system`.',
+                        description: 'ID of the [workspace](https://docs.seam.co/latest/core-concepts/workspaces) that contains the [access control system](https://docs.seam.co/latest/capability-guides/access-systems).',
                         format: 'uuid',
                         type: 'string',
                     },
@@ -1841,7 +1871,7 @@ export default {
                 description: 'Represents a [user](https://docs.seam.co/latest/capability-guides/access-systems/user-management) in an [access control system](https://docs.seam.co/latest/capability-guides/access-systems).',
                 properties: {
                     access_schedule: {
-                        description: "`starts_at` and `ends_at` timestamps for the `acs_user`'s access.",
+                        description: "`starts_at` and `ends_at` timestamps for the [ACS user's](https://docs.seam.co/latest/capability-guides/access-systems/user-management) access.",
                         properties: {
                             ends_at: {
                                 description: "Date and time at which the user's access ends, in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format.",
@@ -1859,22 +1889,22 @@ export default {
                         type: 'object',
                     },
                     acs_system_id: {
-                        description: 'ID of the access control system that contains the `acs_user`.',
+                        description: 'ID of the [access control system](https://docs.seam.co/latest/capability-guides/access-systems) that contains the [ACS user](https://docs.seam.co/latest/capability-guides/access-systems/user-management).',
                         format: 'uuid',
                         type: 'string',
                     },
                     acs_user_id: {
-                        description: 'ID of the `acs_user`.',
+                        description: 'ID of the [ACS user](https://docs.seam.co/latest/capability-guides/access-systems/user-management).',
                         format: 'uuid',
                         type: 'string',
                     },
                     created_at: {
-                        description: 'Date and time at which the `acs_user` was created.',
+                        description: 'Date and time at which the [ACS user](https://docs.seam.co/latest/capability-guides/access-systems/user-management) was created.',
                         format: 'date-time',
                         type: 'string',
                     },
                     display_name: {
-                        description: 'Display name for the `acs_user`.',
+                        description: 'Display name for the [ACS user](https://docs.seam.co/latest/capability-guides/access-systems/user-management).',
                         type: 'string',
                     },
                     email: {
@@ -1884,18 +1914,18 @@ export default {
                         'x-deprecated': 'use email_address.',
                     },
                     email_address: {
-                        description: 'Email address of the `acs_user`.',
+                        description: 'Email address of the [ACS user](https://docs.seam.co/latest/capability-guides/access-systems/user-management).',
                         format: 'email',
                         type: 'string',
                     },
                     errors: {
-                        description: 'Errors associated with the `acs_user`.',
+                        description: 'Errors associated with the [ACS user](https://docs.seam.co/latest/capability-guides/access-systems/user-management).',
                         items: {
-                            description: 'Error associated with the `acs_user`.',
+                            description: 'Errors associated with the [ACS user](https://docs.seam.co/latest/capability-guides/access-systems/user-management).',
                             discriminator: { propertyName: 'error_code' },
                             oneOf: [
                                 {
-                                    description: 'Indicates that the ACS user was deleted from the ACS system outside of Seam.',
+                                    description: 'Indicates that the [ACS user](https://docs.seam.co/latest/capability-guides/access-systems/user-management) was deleted from the [access control system](https://docs.seam.co/latest/capability-guides/access-systems) outside of Seam.',
                                     properties: {
                                         created_at: {
                                             description: 'Date and time at which Seam created the error.',
@@ -1915,7 +1945,7 @@ export default {
                                     type: 'object',
                                 },
                                 {
-                                    description: 'Indicates that the user could not be subscribed on Salto KS because the subscription limit has been exceeded.',
+                                    description: 'Indicates that the [ACS user](https://docs.seam.co/latest/capability-guides/access-systems/user-management) could not be subscribed on Salto KS because the subscription limit has been exceeded.',
                                     properties: {
                                         created_at: {
                                             description: 'Date and time at which Seam created the error.',
@@ -1935,7 +1965,7 @@ export default {
                                     type: 'object',
                                 },
                                 {
-                                    description: "Indicates that the user was not created on the ACS system. This is likely due to an internal unexpected error. Please contact Seam's support if you encounter this.",
+                                    description: 'Indicates that the [ACS user](https://docs.seam.co/latest/capability-guides/access-systems/user-management) was not created on the [access control 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).',
                                     properties: {
                                         created_at: {
                                             description: 'Date and time at which Seam created the error.',
@@ -1955,7 +1985,7 @@ export default {
                                     type: 'object',
                                 },
                                 {
-                                    description: "Indicates that the user was not updated on the ACS system. This is likely due to an internal unexpected error. Please contact Seam's support if you encounter this.",
+                                    description: 'Indicates that the [ACS user](https://docs.seam.co/latest/capability-guides/access-systems/user-management) was not updated on the [access control 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).',
                                     properties: {
                                         created_at: {
                                             description: 'Date and time at which Seam created the error.',
@@ -1975,7 +2005,7 @@ export default {
                                     type: 'object',
                                 },
                                 {
-                                    description: "Indicates that the user was not deleted on the ACS system. This is likely due to an internal unexpected error. Please contact Seam's support if you encounter this.",
+                                    description: 'Indicates that the [ACS user](https://docs.seam.co/latest/capability-guides/access-systems/user-management) was not deleted on the [access control 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).',
                                     properties: {
                                         created_at: {
                                             description: 'Date and time at which Seam created the error.',
@@ -1999,7 +2029,7 @@ export default {
                         type: 'array',
                     },
                     external_type: {
-                        description: 'Brand-specific terminology for the `acs_user` type.',
+                        description: 'Brand-specific terminology for the [ACS user](https://docs.seam.co/latest/capability-guides/access-systems/user-management) type.',
                         enum: [
                             'pti_user',
                             'brivo_user',
@@ -2012,11 +2042,11 @@ export default {
                         type: 'string',
                     },
                     external_type_display_name: {
-                        description: 'Display name that corresponds to the brand-specific terminology for the `acs_user` type.',
+                        description: 'Display name that corresponds to the brand-specific terminology for the [ACS user](https://docs.seam.co/latest/capability-guides/access-systems/user-management) type.',
                         type: 'string',
                     },
                     full_name: {
-                        description: 'Full name of the `acs_user`.',
+                        description: 'Full name of the [ACS user](https://docs.seam.co/latest/capability-guides/access-systems/user-management).',
                         type: 'string',
                     },
                     hid_acs_system_id: { format: 'uuid', type: 'string' },
@@ -2027,7 +2057,7 @@ export default {
                     },
                     is_managed: { enum: [true], type: 'boolean' },
                     is_suspended: {
-                        description: 'Indicates whether the `acs_user` is currently [suspended](https://docs.seam.co/latest/capability-guides/access-systems/user-management/suspending-and-unsuspending-users).',
+                        description: 'Indicates whether the [ACS user](https://docs.seam.co/latest/capability-guides/access-systems/user-management) is currently [suspended](https://docs.seam.co/latest/capability-guides/access-systems/user-management/suspending-and-unsuspending-users).',
                         type: 'boolean',
                     },
                     latest_desired_state_synced_with_provider_at: {
@@ -2037,49 +2067,63 @@ export default {
                         'x-undocumented': 'Only used internally.',
                     },
                     phone_number: {
-                        description: 'Phone number of the `acs_user` in E.164 format (for example, `+15555550100`).',
+                        description: 'Phone number of the [ACS user](https://docs.seam.co/latest/capability-guides/access-systems/user-management) in E.164 format (for example, `+15555550100`).',
                         type: 'string',
                     },
                     user_identity_email_address: {
-                        description: 'Email address of the user identity associated with the `acs_user`.',
+                        description: 'Email address of the user identity associated with the [ACS user](https://docs.seam.co/latest/capability-guides/access-systems/user-management).',
                         nullable: true,
                         type: 'string',
                     },
                     user_identity_full_name: {
-                        description: 'Full name of the user identity associated with the `acs_user`.',
+                        description: 'Full name of the user identity associated with the [ACS user](https://docs.seam.co/latest/capability-guides/access-systems/user-management).',
                         nullable: true,
                         type: 'string',
                     },
                     user_identity_id: {
-                        description: 'ID of the user identity associated with the `acs_user`.',
+                        description: 'ID of the user identity associated with the [ACS user](https://docs.seam.co/latest/capability-guides/access-systems/user-management).',
                         type: 'string',
                     },
                     user_identity_phone_number: {
-                        description: 'Phone number of the user identity associated with the `acs_user` in E.164 format (for example, `+15555550100`).',
+                        description: 'Phone number of the user identity associated with the [ACS user](https://docs.seam.co/latest/capability-guides/access-systems/user-management) in E.164 format (for example, `+15555550100`).',
                         nullable: true,
                         type: 'string',
                     },
                     warnings: {
-                        description: 'Warnings associated with the `acs_user`.',
+                        description: 'Warnings associated with the [ACS user](https://docs.seam.co/latest/capability-guides/access-systems/user-management).',
                         items: {
-                            description: 'Warning associated with the `acs_user`.',
+                            description: 'Warnings associated with the [ACS user](https://docs.seam.co/latest/capability-guides/access-systems/user-management).',
                             discriminator: { propertyName: 'warning_code' },
                             oneOf: [
                                 {
-                                    description: 'Indicates that the user is being deleted from the ACS system. This is a temporary state, and the user will be deleted shortly.',
+                                    description: 'Indicates that the [ACS user](https://docs.seam.co/latest/capability-guides/access-systems/user-management) is being deleted from the [access control system](https://docs.seam.co/latest/capability-guides/access-systems). This is a temporary state, and the ACS user will be deleted shortly.',
                                     properties: {
-                                        created_at: { format: 'date-time', type: 'string' },
-                                        message: { type: 'string' },
+                                        created_at: {
+                                            description: 'Date and time at which Seam created the warning.',
+                                            format: 'date-time',
+                                            type: 'string',
+                                        },
+                                        message: {
+                                            description: 'Detailed description of the warning. Provides insights into the issue and potentially how to rectify it.',
+                                            type: 'string',
+                                        },
                                         warning_code: { enum: ['being_deleted'], type: 'string' },
                                     },
                                     required: ['created_at', 'message', 'warning_code'],
                                     type: 'object',
                                 },
                                 {
-                                    description: 'Indicates that the user is not subscribed on the Salto KS, so they cannot unlock doors or perform any actions. This occur when the their access schedule hasn’t started yet, or if their access schedule has ended, or if the site has reached its limit for active users (subscription slots), or if they have been manually unsubscribed.',
+                                    description: 'Indicates that the [ACS user](https://docs.seam.co/latest/capability-guides/access-systems/user-management) is not subscribed on Salto KS, so they cannot unlock doors or perform any actions. This occurs when the their access schedule hasn’t started yet, if their access schedule has ended, if the site has reached its limit for active users (subscription slots), or if they have been manually unsubscribed.',
                                     properties: {
-                                        created_at: { format: 'date-time', type: 'string' },
-                                        message: { type: 'string' },
+                                        created_at: {
+                                            description: 'Date and time at which Seam created the warning.',
+                                            format: 'date-time',
+                                            type: 'string',
+                                        },
+                                        message: {
+                                            description: 'Detailed description of the warning. Provides insights into the issue and potentially how to rectify it.',
+                                            type: 'string',
+                                        },
                                         warning_code: {
                                             enum: ['salto_ks_user_not_subscribed'],
                                             type: 'string',
@@ -2089,10 +2133,17 @@ export default {
                                     type: 'object',
                                 },
                                 {
-                                    description: 'An unknown issue occurred while syncing the state of this user with the provider. This issue may affect the proper functioning of this user.',
+                                    description: 'An unknown issue occurred while syncing the state of this [ACS user](https://docs.seam.co/latest/capability-guides/access-systems/user-management) with the provider. This issue may affect the proper functioning of this user.',
                                     properties: {
-                                        created_at: { format: 'date-time', type: 'string' },
-                                        message: { type: 'string' },
+                                        created_at: {
+                                            description: 'Date and time at which Seam created the warning.',
+                                            format: 'date-time',
+                                            type: 'string',
+                                        },
+                                        message: {
+                                            description: 'Detailed description of the warning. Provides insights into the issue and potentially how to rectify it.',
+                                            type: 'string',
+                                        },
                                         warning_code: {
                                             enum: ['unknown_issue_with_acs_user'],
                                             type: 'string',
@@ -2106,7 +2157,7 @@ export default {
                         type: 'array',
                     },
                     workspace_id: {
-                        description: 'ID of the [workspace](https://docs.seam.co/latest/core-concepts/workspaces) that contains the `acs_user`.',
+                        description: 'ID of the [workspace](https://docs.seam.co/latest/core-concepts/workspaces) that contains the [ACS user](https://docs.seam.co/latest/capability-guides/access-systems/user-management).',
                         format: 'uuid',
                         type: 'string',
                     },
@@ -2319,56 +2370,84 @@ export default {
                                         nullable: true,
                                         properties: {
                                             card_number: {
-                                                description: 'A number or string that physically identifies this card.',
+                                                description: 'A number or string that physically identifies the card associated with the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials).',
                                                 nullable: true,
                                                 type: 'string',
                                             },
                                             created_at: {
-                                                description: 'Date and time the credential was created.',
+                                                description: 'Date and time at which the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) was created.',
                                                 format: 'date-time',
                                                 nullable: true,
                                                 type: 'string',
                                             },
                                             ends_at: {
-                                                description: 'Date and time the credential will stop being useable.',
+                                                description: 'Date and time at which the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) will stop being usable.',
                                                 format: 'date-time',
                                                 nullable: true,
                                                 type: 'string',
                                             },
                                             is_issued: { nullable: true, type: 'boolean' },
                                             starts_at: {
-                                                description: 'Date and time the credential will become useable.',
+                                                description: 'Date and time at which the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) becomes usable.',
                                                 format: 'date-time',
                                                 nullable: true,
                                                 type: 'string',
                                             },
                                             visionline_metadata: {
-                                                description: 'Visionline-specific metadata for the credential.',
+                                                description: 'Visionline-specific metadata for the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials).',
                                                 properties: {
-                                                    cancelled: { type: 'boolean' },
+                                                    cancelled: {
+                                                        description: 'Indicates whether the card associated with the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) is cancelled.',
+                                                        type: 'boolean',
+                                                    },
                                                     card_format: {
+                                                        description: 'Format of the card associated with the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials).',
                                                         enum: ['TLCode', 'rfid48'],
                                                         type: 'string',
                                                     },
-                                                    card_holder: { type: 'string' },
-                                                    card_id: { type: 'string' },
+                                                    card_holder: {
+                                                        description: 'Holden of the card associated with the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials).',
+                                                        type: 'string',
+                                                    },
+                                                    card_id: {
+                                                        description: 'Card ID for the Visionline card associated with the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials).',
+                                                        type: 'string',
+                                                    },
                                                     common_acs_entrance_ids: {
+                                                        description: 'IDs of the common [entrances](https://docs.seam.co/latest/capability-guides/access-systems/retrieving-entrance-details) for the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials).',
                                                         items: { format: 'uuid', type: 'string' },
                                                         type: 'array',
                                                     },
-                                                    discarded: { type: 'boolean' },
-                                                    expired: { type: 'boolean' },
+                                                    discarded: {
+                                                        description: 'Indicates whether the card associated with the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) is discarded.',
+                                                        type: 'boolean',
+                                                    },
+                                                    expired: {
+                                                        description: 'Indicates whether the card associated with the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) is expired.',
+                                                        type: 'boolean',
+                                                    },
                                                     guest_acs_entrance_ids: {
+                                                        description: 'IDs of the guest [entrances](https://docs.seam.co/latest/capability-guides/access-systems/retrieving-entrance-details) for the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials).',
                                                         items: { format: 'uuid', type: 'string' },
                                                         type: 'array',
                                                     },
                                                     number_of_issued_cards: {
+                                                        description: 'Number of issued cards associated with the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials).',
                                                         format: 'float',
                                                         type: 'number',
                                                     },
-                                                    overridden: { type: 'boolean' },
-                                                    overwritten: { type: 'boolean' },
-                                                    pending_auto_update: { type: 'boolean' },
+                                                    overridden: {
+                                                        description: 'Indicates whether the card associated with the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) is overridden.',
+                                                        type: 'boolean',
+                                                    },
+                                                    overwritten: {
+                                                        description: 'Indicates whether the card associated with the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) is overwritten.',
+                                                        type: 'boolean',
+                                                    },
+                                                    pending_auto_update: {
+                                                        description: 'Indicates whether the card associated with the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) is pending auto-update.',
+                                                        type: 'boolean',
+                                                    },
                                                 },
                                                 required: [
                                                     'card_id',
@@ -2397,15 +2476,15 @@ export default {
                                         nullable: true,
                                         oneOf: [
                                             {
-                                                description: 'Means by which a user gains access at an entrance. The `acs_credential` object represents a credential that provides an ACS user access within an access control system. For each acs_credential object, you define the access method. You can also specify additional properties, such as a code.',
+                                                description: 'Means by which an [ACS user](https://docs.seam.co/latest/capability-guides/access-systems/user-management) gains access at an [entrance](https://docs.seam.co/latest/capability-guides/access-systems/retrieving-entrance-details). The `acs_credential` object represents a [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) that provides an ACS user access within an [access control system](https://docs.seam.co/latest/capability-guides/access-systems). For each `acs_credential` object, you define the access method. You can also specify additional properties, such as a PIN code.',
                                                 properties: {
                                                     access_method: {
-                                                        description: 'Access method for the credential. Supported values: `code`, `card`, `mobile_key`.',
+                                                        description: 'Access method for the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials). Supported values: `code`, `card`, `mobile_key`.',
                                                         enum: ['code', 'card', 'mobile_key'],
                                                         type: 'string',
                                                     },
                                                     acs_credential_id: {
-                                                        description: 'ID of the credential.',
+                                                        description: 'ID of the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials).',
                                                         format: 'uuid',
                                                         type: 'string',
                                                     },
@@ -2414,17 +2493,17 @@ export default {
                                                         type: 'string',
                                                     },
                                                     acs_system_id: {
-                                                        description: 'ID of the access control system that contains the credential.',
+                                                        description: 'ID of the [access control system](https://docs.seam.co/latest/capability-guides/access-systems) that contains the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials).',
                                                         format: 'uuid',
                                                         type: 'string',
                                                     },
                                                     acs_user_id: {
-                                                        description: 'ID of the ACS user to whom the credential belongs.',
+                                                        description: 'ID of the [ACS user](https://docs.seam.co/latest/capability-guides/access-systems/user-management) to whom the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) belongs.',
                                                         format: 'uuid',
                                                         type: 'string',
                                                     },
                                                     assa_abloy_vostio_metadata: {
-                                                        description: 'Vostio-specific metadata for the credential.',
+                                                        description: 'Vostio-specific metadata for the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials).',
                                                         properties: {
                                                             door_names: {
                                                                 items: { type: 'string' },
@@ -2440,28 +2519,32 @@ export default {
                                                         },
                                                         type: 'object',
                                                     },
-                                                    card_number: { nullable: true, type: 'string' },
+                                                    card_number: {
+                                                        description: 'Number of the card associated with the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials).',
+                                                        nullable: true,
+                                                        type: 'string',
+                                                    },
                                                     code: {
-                                                        description: 'Access (PIN) code for the credential.',
+                                                        description: 'Access (PIN) code for the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials).',
                                                         nullable: true,
                                                         type: 'string',
                                                     },
                                                     created_at: {
-                                                        description: 'Date and time at which the credential was created.',
+                                                        description: 'Date and time at which the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) was created.',
                                                         format: 'date-time',
                                                         type: 'string',
                                                     },
                                                     display_name: {
-                                                        description: 'Display name that corresponds to the credential type.',
+                                                        description: 'Display name that corresponds to the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) type.',
                                                         minLength: 1,
                                                         type: 'string',
                                                     },
                                                     ends_at: {
-                                                        description: 'Date and time at which the credential validity ends, in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format. Must be a time in the future and after `starts_at`.',
+                                                        description: 'Date and time at which the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) validity ends, in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format. Must be a time in the future and after `starts_at`.',
                                                         type: 'string',
                                                     },
                                                     errors: {
-                                                        description: 'Errors associated with the `acs_credential`.',
+                                                        description: 'Errors associated with the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials).',
                                                         items: {
                                                             properties: {
                                                                 error_code: { type: 'string' },
@@ -2473,7 +2556,7 @@ export default {
                                                         type: 'array',
                                                     },
                                                     external_type: {
-                                                        description: 'Brand-specific terminology for the credential type. Supported values: `pti_card`, `brivo_credential`, `hid_credential`, `visionline_card`.',
+                                                        description: 'Brand-specific terminology for the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) type. Supported values: `pti_card`, `brivo_credential`, `hid_credential`, `visionline_card`.',
                                                         enum: [
                                                             'pti_card',
                                                             'brivo_credential',
@@ -2486,46 +2569,50 @@ export default {
                                                         type: 'string',
                                                     },
                                                     external_type_display_name: {
-                                                        description: 'Display name that corresponds to the brand-specific terminology for the credential type.',
+                                                        description: 'Display name that corresponds to the brand-specific terminology for the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) type.',
                                                         type: 'string',
                                                     },
-                                                    is_issued: { type: 'boolean' },
+                                                    is_issued: {
+                                                        description: 'Indicates whether the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) has been encoded onto a card.',
+                                                        type: 'boolean',
+                                                    },
                                                     is_latest_desired_state_synced_with_provider: {
-                                                        description: 'Indicates whether the latest state of the credential has been synced from Seam to the provider.',
+                                                        description: 'Indicates whether the latest state of the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) has been synced from Seam to the provider.',
                                                         nullable: true,
                                                         type: 'boolean',
                                                     },
                                                     is_managed: { enum: [true], type: 'boolean' },
                                                     is_multi_phone_sync_credential: {
-                                                        description: 'Indicates whether the credential is a [multi-phone sync credential](https://docs.seam.co/latest/capability-guides/mobile-access-in-development/issuing-mobile-credentials-from-an-access-control-system#what-are-multi-phone-sync-credentials).',
+                                                        description: 'Indicates whether the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) is a [multi-phone sync credential](https://docs.seam.co/latest/capability-guides/mobile-access-in-development/issuing-mobile-credentials-from-an-access-control-system#what-are-multi-phone-sync-credentials).',
                                                         type: 'boolean',
                                                     },
                                                     is_one_time_use: {
-                                                        description: 'Indicates whether the credential can only be used once. If "true," the code becomes invalid after the first use.',
+                                                        description: 'Indicates whether the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) can only be used once. If `true`, the code becomes invalid after the first use.',
                                                         type: 'boolean',
                                                     },
                                                     issued_at: {
+                                                        description: 'Date and time at which the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) was encoded onto a card.',
                                                         format: 'date-time',
                                                         nullable: true,
                                                         type: 'string',
                                                     },
                                                     latest_desired_state_synced_with_provider_at: {
-                                                        description: 'Date and time at which the state of the credential was most recently synced from Seam to the provider.',
+                                                        description: 'Date and time at which the state of the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) was most recently synced from Seam to the provider.',
                                                         format: 'date-time',
                                                         nullable: true,
                                                         type: 'string',
                                                     },
                                                     parent_acs_credential_id: {
-                                                        description: 'ID of the parent credential.',
+                                                        description: 'ID of the parent [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials).',
                                                         format: 'uuid',
                                                         type: 'string',
                                                     },
                                                     starts_at: {
-                                                        description: 'Date and time at which the credential validity starts, in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format.',
+                                                        description: 'Date and time at which the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) validity starts, in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format.',
                                                         type: 'string',
                                                     },
                                                     visionline_metadata: {
-                                                        description: 'Visionline-specific metadata for the credential.',
+                                                        description: 'Visionline-specific metadata for the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials).',
                                                         properties: {
                                                             auto_join: { type: 'boolean' },
                                                             card_function_type: {
@@ -2552,13 +2639,13 @@ export default {
                                                         type: 'object',
                                                     },
                                                     warnings: {
-                                                        description: 'Warnings associated with the `acs_credential`.',
+                                                        description: 'Warnings associated with the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials).',
                                                         items: {
-                                                            description: 'Warning associated with the `acs_credential`.',
+                                                            description: 'Warning associated with the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials).',
                                                             discriminator: { propertyName: 'warning_code' },
                                                             oneOf: [
                                                                 {
-                                                                    description: 'Indicates that the credential is waiting to be issued.',
+                                                                    description: 'Indicates that the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) is waiting to be issued.',
                                                                     properties: {
                                                                         created_at: {
                                                                             description: 'Date and time at which Seam created the warning.',
@@ -2583,7 +2670,7 @@ export default {
                                                                     type: 'object',
                                                                 },
                                                                 {
-                                                                    description: "Indicates that the schedule of one of the credential's children was modified externally.",
+                                                                    description: "Indicates that the schedule of one of the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials)'s children was modified externally.",
                                                                     properties: {
                                                                         created_at: {
                                                                             description: 'Date and time at which Seam created the warning.',
@@ -2608,7 +2695,7 @@ export default {
                                                                     type: 'object',
                                                                 },
                                                                 {
-                                                                    description: 'Indicates that the schedule of this credential was modified to avoid creating a credential with a start date in the past.',
+                                                                    description: 'Indicates that the schedule of the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) was modified to avoid creating a credential with a start date in the past.',
                                                                     properties: {
                                                                         created_at: {
                                                                             description: 'Date and time at which Seam created the warning.',
@@ -2633,7 +2720,7 @@ export default {
                                                                     type: 'object',
                                                                 },
                                                                 {
-                                                                    description: 'Indicates that this credential is being deleted.',
+                                                                    description: 'Indicates that the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) is being deleted.',
                                                                     properties: {
                                                                         created_at: {
                                                                             description: 'Date and time at which Seam created the warning.',
@@ -2658,7 +2745,7 @@ export default {
                                                                     type: 'object',
                                                                 },
                                                                 {
-                                                                    description: 'An unknown issue occurred while syncing the state of this credential with the provider. This issue may affect the proper functioning of this credential.',
+                                                                    description: 'An unknown issue occurred while syncing the state of the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) with the provider. This issue may affect the proper functioning of the credential.',
                                                                     properties: {
                                                                         created_at: {
                                                                             description: 'Date and time at which Seam created the warning.',
@@ -2685,7 +2772,7 @@ export default {
                                                                     type: 'object',
                                                                 },
                                                                 {
-                                                                    description: 'Access permissions for this [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) have changed. [Reissue](https://docs.seam.co/latest/capability-guides/access-systems/working-with-card-encoders-and-scanners/creating-and-encoding-card-based-credentials) (re-encode) this credential. This issue may affect the proper functioning of the credential.',
+                                                                    description: 'Access permissions for the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) have changed. [Reissue](https://docs.seam.co/latest/capability-guides/access-systems/working-with-card-encoders-and-scanners/creating-and-encoding-card-based-credentials) (re-encode) the credential. This issue may affect the proper functioning of the credential.',
                                                                     properties: {
                                                                         created_at: {
                                                                             description: 'Date and time at which Seam created the warning.',
@@ -2714,7 +2801,7 @@ export default {
                                                         type: 'array',
                                                     },
                                                     workspace_id: {
-                                                        description: 'ID of the [workspace](https://docs.seam.co/latest/core-concepts/workspaces) that contains the credential.',
+                                                        description: 'ID of the [workspace](https://docs.seam.co/latest/core-concepts/workspaces) that contains the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials).',
                                                         format: 'uuid',
                                                         type: 'string',
                                                     },
@@ -2734,15 +2821,15 @@ export default {
                                                 'x-route-path': '/acs/credentials',
                                             },
                                             {
-                                                description: 'Means by which a user gains access at an entrance. The `unmanaged_acs_credential` object, which is not managed by Seam, represents a credential that provides an ACS user access within an access control system. For each acs_credential object, you define the access method. You can also specify additional properties, such as a code.',
+                                                description: 'Means by which an [ACS user](https://docs.seam.co/latest/capability-guides/access-systems/user-management) gains access at an [entrance](https://docs.seam.co/latest/capability-guides/access-systems/retrieving-entrance-details). The `unmanaged_acs_credential` object, which is not managed by Seam, represents a [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) that provides an ACS user access within an [access control system](https://docs.seam.co/latest/capability-guides/access-systems). For each `acs_credential` object, you define the access method. You can also specify additional properties, such as a PIN code.',
                                                 properties: {
                                                     access_method: {
-                                                        description: 'Access method for the credential. Supported values: `code`, `card`, `mobile_key`.',
+                                                        description: 'Access method for the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials). Supported values: `code`, `card`, `mobile_key`.',
                                                         enum: ['code', 'card', 'mobile_key'],
                                                         type: 'string',
                                                     },
                                                     acs_credential_id: {
-                                                        description: 'ID of the credential.',
+                                                        description: 'ID of the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials).',
                                                         format: 'uuid',
                                                         type: 'string',
                                                     },
@@ -2751,17 +2838,17 @@ export default {
                                                         type: 'string',
                                                     },
                                                     acs_system_id: {
-                                                        description: 'ID of the access control system that contains the credential.',
+                                                        description: 'ID of the [access control system](https://docs.seam.co/latest/capability-guides/access-systems) that contains the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials).',
                                                         format: 'uuid',
                                                         type: 'string',
                                                     },
                                                     acs_user_id: {
-                                                        description: 'ID of the ACS user to whom the credential belongs.',
+                                                        description: 'ID of the [ACS user](https://docs.seam.co/latest/capability-guides/access-systems/user-management) to whom the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) belongs.',
                                                         format: 'uuid',
                                                         type: 'string',
                                                     },
                                                     assa_abloy_vostio_metadata: {
-                                                        description: 'Vostio-specific metadata for the credential.',
+                                                        description: 'Vostio-specific metadata for the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials).',
                                                         properties: {
                                                             door_names: {
                                                                 items: { type: 'string' },
@@ -2777,28 +2864,32 @@ export default {
                                                         },
                                                         type: 'object',
                                                     },
-                                                    card_number: { nullable: true, type: 'string' },
+                                                    card_number: {
+                                                        description: 'Number of the card associated with the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials).',
+                                                        nullable: true,
+                                                        type: 'string',
+                                                    },
                                                     code: {
-                                                        description: 'Access (PIN) code for the credential.',
+                                                        description: 'Access (PIN) code for the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials).',
                                                         nullable: true,
                                                         type: 'string',
                                                     },
                                                     created_at: {
-                                                        description: 'Date and time at which the credential was created.',
+                                                        description: 'Date and time at which the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) was created.',
                                                         format: 'date-time',
                                                         type: 'string',
                                                     },
                                                     display_name: {
-                                                        description: 'Display name that corresponds to the credential type.',
+                                                        description: 'Display name that corresponds to the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) type.',
                                                         minLength: 1,
                                                         type: 'string',
                                                     },
                                                     ends_at: {
-                                                        description: 'Date and time at which the credential validity ends, in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format. Must be a time in the future and after `starts_at`.',
+                                                        description: 'Date and time at which the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) validity ends, in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format. Must be a time in the future and after `starts_at`.',
                                                         type: 'string',
                                                     },
                                                     errors: {
-                                                        description: 'Errors associated with the `acs_credential`.',
+                                                        description: 'Errors associated with the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials).',
                                                         items: {
                                                             properties: {
                                                                 error_code: { type: 'string' },
@@ -2810,7 +2901,7 @@ export default {
                                                         type: 'array',
                                                     },
                                                     external_type: {
-                                                        description: 'Brand-specific terminology for the credential type. Supported values: `pti_card`, `brivo_credential`, `hid_credential`, `visionline_card`.',
+                                                        description: 'Brand-specific terminology for the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) type. Supported values: `pti_card`, `brivo_credential`, `hid_credential`, `visionline_card`.',
                                                         enum: [
                                                             'pti_card',
                                                             'brivo_credential',
@@ -2823,46 +2914,50 @@ export default {
                                                         type: 'string',
                                                     },
                                                     external_type_display_name: {
-                                                        description: 'Display name that corresponds to the brand-specific terminology for the credential type.',
+                                                        description: 'Display name that corresponds to the brand-specific terminology for the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) type.',
                                                         type: 'string',
                                                     },
-                                                    is_issued: { type: 'boolean' },
+                                                    is_issued: {
+                                                        description: 'Indicates whether the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) has been encoded onto a card.',
+                                                        type: 'boolean',
+                                                    },
                                                     is_latest_desired_state_synced_with_provider: {
-                                                        description: 'Indicates whether the latest state of the credential has been synced from Seam to the provider.',
+                                                        description: 'Indicates whether the latest state of the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) has been synced from Seam to the provider.',
                                                         nullable: true,
                                                         type: 'boolean',
                                                     },
                                                     is_managed: { enum: [false], type: 'boolean' },
                                                     is_multi_phone_sync_credential: {
-                                                        description: 'Indicates whether the credential is a [multi-phone sync credential](https://docs.seam.co/latest/capability-guides/mobile-access-in-development/issuing-mobile-credentials-from-an-access-control-system#what-are-multi-phone-sync-credentials).',
+                                                        description: 'Indicates whether the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) is a [multi-phone sync credential](https://docs.seam.co/latest/capability-guides/mobile-access-in-development/issuing-mobile-credentials-from-an-access-control-system#what-are-multi-phone-sync-credentials).',
                                                         type: 'boolean',
                                                     },
                                                     is_one_time_use: {
-                                                        description: 'Indicates whether the credential can only be used once. If "true," the code becomes invalid after the first use.',
+                                                        description: 'Indicates whether the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) can only be used once. If `true`, the code becomes invalid after the first use.',
                                                         type: 'boolean',
                                                     },
                                                     issued_at: {
+                                                        description: 'Date and time at which the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) was encoded onto a card.',
                                                         format: 'date-time',
                                                         nullable: true,
                                                         type: 'string',
                                                     },
                                                     latest_desired_state_synced_with_provider_at: {
-                                                        description: 'Date and time at which the state of the credential was most recently synced from Seam to the provider.',
+                                                        description: 'Date and time at which the state of the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) was most recently synced from Seam to the provider.',
                                                         format: 'date-time',
                                                         nullable: true,
                                                         type: 'string',
                                                     },
                                                     parent_acs_credential_id: {
-                                                        description: 'ID of the parent credential.',
+                                                        description: 'ID of the parent [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials).',
                                                         format: 'uuid',
                                                         type: 'string',
                                                     },
                                                     starts_at: {
-                                                        description: 'Date and time at which the credential validity starts, in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format.',
+                                                        description: 'Date and time at which the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) validity starts, in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format.',
                                                         type: 'string',
                                                     },
                                                     visionline_metadata: {
-                                                        description: 'Visionline-specific metadata for the credential.',
+                                                        description: 'Visionline-specific metadata for the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials).',
                                                         properties: {
                                                             auto_join: { type: 'boolean' },
                                                             card_function_type: {
@@ -2889,13 +2984,13 @@ export default {
                                                         type: 'object',
                                                     },
                                                     warnings: {
-                                                        description: 'Warnings associated with the `acs_credential`.',
+                                                        description: 'Warnings associated with the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials).',
                                                         items: {
-                                                            description: 'Warning associated with the `acs_credential`.',
+                                                            description: 'Warning associated with the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials).',
                                                             discriminator: { propertyName: 'warning_code' },
                                                             oneOf: [
                                                                 {
-                                                                    description: 'Indicates that the credential is waiting to be issued.',
+                                                                    description: 'Indicates that the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) is waiting to be issued.',
                                                                     properties: {
                                                                         created_at: {
                                                                             description: 'Date and time at which Seam created the warning.',
@@ -2920,7 +3015,7 @@ export default {
                                                                     type: 'object',
                                                                 },
                                                                 {
-                                                                    description: "Indicates that the schedule of one of the credential's children was modified externally.",
+                                                                    description: "Indicates that the schedule of one of the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials)'s children was modified externally.",
                                                                     properties: {
                                                                         created_at: {
                                                                             description: 'Date and time at which Seam created the warning.',
@@ -2945,7 +3040,7 @@ export default {
                                                                     type: 'object',
                                                                 },
                                                                 {
-                                                                    description: 'Indicates that the schedule of this credential was modified to avoid creating a credential with a start date in the past.',
+                                                                    description: 'Indicates that the schedule of the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) was modified to avoid creating a credential with a start date in the past.',
                                                                     properties: {
                                                                         created_at: {
                                                                             description: 'Date and time at which Seam created the warning.',
@@ -2970,7 +3065,7 @@ export default {
                                                                     type: 'object',
                                                                 },
                                                                 {
-                                                                    description: 'Indicates that this credential is being deleted.',
+                                                                    description: 'Indicates that the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) is being deleted.',
                                                                     properties: {
                                                                         created_at: {
                                                                             description: 'Date and time at which Seam created the warning.',
@@ -2995,7 +3090,7 @@ export default {
                                                                     type: 'object',
                                                                 },
                                                                 {
-                                                                    description: 'An unknown issue occurred while syncing the state of this credential with the provider. This issue may affect the proper functioning of this credential.',
+                                                                    description: 'An unknown issue occurred while syncing the state of the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) with the provider. This issue may affect the proper functioning of the credential.',
                                                                     properties: {
                                                                         created_at: {
                                                                             description: 'Date and time at which Seam created the warning.',
@@ -3022,7 +3117,7 @@ export default {
                                                                     type: 'object',
                                                                 },
                                                                 {
-                                                                    description: 'Access permissions for this [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) have changed. [Reissue](https://docs.seam.co/latest/capability-guides/access-systems/working-with-card-encoders-and-scanners/creating-and-encoding-card-based-credentials) (re-encode) this credential. This issue may affect the proper functioning of the credential.',
+                                                                    description: 'Access permissions for the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) have changed. [Reissue](https://docs.seam.co/latest/capability-guides/access-systems/working-with-card-encoders-and-scanners/creating-and-encoding-card-based-credentials) (re-encode) the credential. This issue may affect the proper functioning of the credential.',
                                                                     properties: {
                                                                         created_at: {
                                                                             description: 'Date and time at which Seam created the warning.',
@@ -3051,7 +3146,7 @@ export default {
                                                         type: 'array',
                                                     },
                                                     workspace_id: {
-                                                        description: 'ID of the [workspace](https://docs.seam.co/latest/core-concepts/workspaces) that contains the credential.',
+                                                        description: 'ID of the [workspace](https://docs.seam.co/latest/core-concepts/workspaces) that contains the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials).',
                                                         format: 'uuid',
                                                         type: 'string',
                                                     },
@@ -3200,18 +3295,18 @@ export default {
                             action_type: { enum: ['ENCODE_CREDENTIAL'], type: 'string' },
                             error: { nullable: true },
                             result: {
-                                description: 'Means by which a user gains access at an entrance. The `acs_credential` object represents a credential that provides an ACS user access within an access control system. For each acs_credential object, you define the access method. You can also specify additional properties, such as a code.',
+                                description: 'Means by which an [ACS user](https://docs.seam.co/latest/capability-guides/access-systems/user-management) gains access at an [entrance](https://docs.seam.co/latest/capability-guides/access-systems/retrieving-entrance-details). The `acs_credential` object represents a [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) that provides an ACS user access within an [access control system](https://docs.seam.co/latest/capability-guides/access-systems). For each `acs_credential` object, you define the access method. You can also specify additional properties, such as a PIN code.',
                                 oneOf: [
                                     {
-                                        description: 'Means by which a user gains access at an entrance. The `acs_credential` object represents a credential that provides an ACS user access within an access control system. For each acs_credential object, you define the access method. You can also specify additional properties, such as a code.',
+                                        description: 'Means by which an [ACS user](https://docs.seam.co/latest/capability-guides/access-systems/user-management) gains access at an [entrance](https://docs.seam.co/latest/capability-guides/access-systems/retrieving-entrance-details). The `acs_credential` object represents a [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) that provides an ACS user access within an [access control system](https://docs.seam.co/latest/capability-guides/access-systems). For each `acs_credential` object, you define the access method. You can also specify additional properties, such as a PIN code.',
                                         properties: {
                                             access_method: {
-                                                description: 'Access method for the credential. Supported values: `code`, `card`, `mobile_key`.',
+                                                description: 'Access method for the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials). Supported values: `code`, `card`, `mobile_key`.',
                                                 enum: ['code', 'card', 'mobile_key'],
                                                 type: 'string',
                                             },
                                             acs_credential_id: {
-                                                description: 'ID of the credential.',
+                                                description: 'ID of the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials).',
                                                 format: 'uuid',
                                                 type: 'string',
                                             },
@@ -3220,17 +3315,17 @@ export default {
                                                 type: 'string',
                                             },
                                             acs_system_id: {
-                                                description: 'ID of the access control system that contains the credential.',
+                                                description: 'ID of the [access control system](https://docs.seam.co/latest/capability-guides/access-systems) that contains the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials).',
                                                 format: 'uuid',
                                                 type: 'string',
                                             },
                                             acs_user_id: {
-                                                description: 'ID of the ACS user to whom the credential belongs.',
+                                                description: 'ID of the [ACS user](https://docs.seam.co/latest/capability-guides/access-systems/user-management) to whom the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) belongs.',
                                                 format: 'uuid',
                                                 type: 'string',
                                             },
                                             assa_abloy_vostio_metadata: {
-                                                description: 'Vostio-specific metadata for the credential.',
+                                                description: 'Vostio-specific metadata for the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials).',
                                                 properties: {
                                                     door_names: {
                                                         items: { type: 'string' },
@@ -3246,28 +3341,32 @@ export default {
                                                 },
                                                 type: 'object',
                                             },
-                                            card_number: { nullable: true, type: 'string' },
+                                            card_number: {
+                                                description: 'Number of the card associated with the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials).',
+                                                nullable: true,
+                                                type: 'string',
+                                            },
                                             code: {
-                                                description: 'Access (PIN) code for the credential.',
+                                                description: 'Access (PIN) code for the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials).',
                                                 nullable: true,
                                                 type: 'string',
                                             },
                                             created_at: {
-                                                description: 'Date and time at which the credential was created.',
+                                                description: 'Date and time at which the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) was created.',
                                                 format: 'date-time',
                                                 type: 'string',
                                             },
                                             display_name: {
-                                                description: 'Display name that corresponds to the credential type.',
+                                                description: 'Display name that corresponds to the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) type.',
                                                 minLength: 1,
                                                 type: 'string',
                                             },
                                             ends_at: {
-                                                description: 'Date and time at which the credential validity ends, in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format. Must be a time in the future and after `starts_at`.',
+                                                description: 'Date and time at which the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) validity ends, in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format. Must be a time in the future and after `starts_at`.',
                                                 type: 'string',
                                             },
                                             errors: {
-                                                description: 'Errors associated with the `acs_credential`.',
+                                                description: 'Errors associated with the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials).',
                                                 items: {
                                                     properties: {
                                                         error_code: { type: 'string' },
@@ -3279,7 +3378,7 @@ export default {
                                                 type: 'array',
                                             },
                                             external_type: {
-                                                description: 'Brand-specific terminology for the credential type. Supported values: `pti_card`, `brivo_credential`, `hid_credential`, `visionline_card`.',
+                                                description: 'Brand-specific terminology for the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) type. Supported values: `pti_card`, `brivo_credential`, `hid_credential`, `visionline_card`.',
                                                 enum: [
                                                     'pti_card',
                                                     'brivo_credential',
@@ -3292,46 +3391,50 @@ export default {
                                                 type: 'string',
                                             },
                                             external_type_display_name: {
-                                                description: 'Display name that corresponds to the brand-specific terminology for the credential type.',
+                                                description: 'Display name that corresponds to the brand-specific terminology for the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) type.',
                                                 type: 'string',
                                             },
-                                            is_issued: { type: 'boolean' },
+                                            is_issued: {
+                                                description: 'Indicates whether the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) has been encoded onto a card.',
+                                                type: 'boolean',
+                                            },
                                             is_latest_desired_state_synced_with_provider: {
-                                                description: 'Indicates whether the latest state of the credential has been synced from Seam to the provider.',
+                                                description: 'Indicates whether the latest state of the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) has been synced from Seam to the provider.',
                                                 nullable: true,
                                                 type: 'boolean',
                                             },
                                             is_managed: { enum: [true], type: 'boolean' },
                                             is_multi_phone_sync_credential: {
-                                                description: 'Indicates whether the credential is a [multi-phone sync credential](https://docs.seam.co/latest/capability-guides/mobile-access-in-development/issuing-mobile-credentials-from-an-access-control-system#what-are-multi-phone-sync-credentials).',
+                                                description: 'Indicates whether the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) is a [multi-phone sync credential](https://docs.seam.co/latest/capability-guides/mobile-access-in-development/issuing-mobile-credentials-from-an-access-control-system#what-are-multi-phone-sync-credentials).',
                                                 type: 'boolean',
                                             },
                                             is_one_time_use: {
-                                                description: 'Indicates whether the credential can only be used once. If "true," the code becomes invalid after the first use.',
+                                                description: 'Indicates whether the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) can only be used once. If `true`, the code becomes invalid after the first use.',
                                                 type: 'boolean',
                                             },
                                             issued_at: {
+                                                description: 'Date and time at which the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) was encoded onto a card.',
                                                 format: 'date-time',
                                                 nullable: true,
                                                 type: 'string',
                                             },
                                             latest_desired_state_synced_with_provider_at: {
-                                                description: 'Date and time at which the state of the credential was most recently synced from Seam to the provider.',
+                                                description: 'Date and time at which the state of the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) was most recently synced from Seam to the provider.',
                                                 format: 'date-time',
                                                 nullable: true,
                                                 type: 'string',
                                             },
                                             parent_acs_credential_id: {
-                                                description: 'ID of the parent credential.',
+                                                description: 'ID of the parent [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials).',
                                                 format: 'uuid',
                                                 type: 'string',
                                             },
                                             starts_at: {
-                                                description: 'Date and time at which the credential validity starts, in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format.',
+                                                description: 'Date and time at which the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) validity starts, in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format.',
                                                 type: 'string',
                                             },
                                             visionline_metadata: {
-                                                description: 'Visionline-specific metadata for the credential.',
+                                                description: 'Visionline-specific metadata for the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials).',
                                                 properties: {
                                                     auto_join: { type: 'boolean' },
                                                     card_function_type: {
@@ -3358,13 +3461,13 @@ export default {
                                                 type: 'object',
                                             },
                                             warnings: {
-                                                description: 'Warnings associated with the `acs_credential`.',
+                                                description: 'Warnings associated with the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials).',
                                                 items: {
-                                                    description: 'Warning associated with the `acs_credential`.',
+                                                    description: 'Warning associated with the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials).',
                                                     discriminator: { propertyName: 'warning_code' },
                                                     oneOf: [
                                                         {
-                                                            description: 'Indicates that the credential is waiting to be issued.',
+                                                            description: 'Indicates that the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) is waiting to be issued.',
                                                             properties: {
                                                                 created_at: {
                                                                     description: 'Date and time at which Seam created the warning.',
@@ -3389,7 +3492,7 @@ export default {
                                                             type: 'object',
                                                         },
                                                         {
-                                                            description: "Indicates that the schedule of one of the credential's children was modified externally.",
+                                                            description: "Indicates that the schedule of one of the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials)'s children was modified externally.",
                                                             properties: {
                                                                 created_at: {
                                                                     description: 'Date and time at which Seam created the warning.',
@@ -3414,7 +3517,7 @@ export default {
                                                             type: 'object',
                                                         },
                                                         {
-                                                            description: 'Indicates that the schedule of this credential was modified to avoid creating a credential with a start date in the past.',
+                                                            description: 'Indicates that the schedule of the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) was modified to avoid creating a credential with a start date in the past.',
                                                             properties: {
                                                                 created_at: {
                                                                     description: 'Date and time at which Seam created the warning.',
@@ -3439,7 +3542,7 @@ export default {
                                                             type: 'object',
                                                         },
                                                         {
-                                                            description: 'Indicates that this credential is being deleted.',
+                                                            description: 'Indicates that the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) is being deleted.',
                                                             properties: {
                                                                 created_at: {
                                                                     description: 'Date and time at which Seam created the warning.',
@@ -3464,7 +3567,7 @@ export default {
                                                             type: 'object',
                                                         },
                                                         {
-                                                            description: 'An unknown issue occurred while syncing the state of this credential with the provider. This issue may affect the proper functioning of this credential.',
+                                                            description: 'An unknown issue occurred while syncing the state of the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) with the provider. This issue may affect the proper functioning of the credential.',
                                                             properties: {
                                                                 created_at: {
                                                                     description: 'Date and time at which Seam created the warning.',
@@ -3489,7 +3592,7 @@ export default {
                                                             type: 'object',
                                                         },
                                                         {
-                                                            description: 'Access permissions for this [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) have changed. [Reissue](https://docs.seam.co/latest/capability-guides/access-systems/working-with-card-encoders-and-scanners/creating-and-encoding-card-based-credentials) (re-encode) this credential. This issue may affect the proper functioning of the credential.',
+                                                            description: 'Access permissions for the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) have changed. [Reissue](https://docs.seam.co/latest/capability-guides/access-systems/working-with-card-encoders-and-scanners/creating-and-encoding-card-based-credentials) (re-encode) the credential. This issue may affect the proper functioning of the credential.',
                                                             properties: {
                                                                 created_at: {
                                                                     description: 'Date and time at which Seam created the warning.',
@@ -3518,7 +3621,7 @@ export default {
                                                 type: 'array',
                                             },
                                             workspace_id: {
-                                                description: 'ID of the [workspace](https://docs.seam.co/latest/core-concepts/workspaces) that contains the credential.',
+                                                description: 'ID of the [workspace](https://docs.seam.co/latest/core-concepts/workspaces) that contains the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials).',
                                                 format: 'uuid',
                                                 type: 'string',
                                             },
@@ -3538,15 +3641,15 @@ export default {
                                         'x-route-path': '/acs/credentials',
                                     },
                                     {
-                                        description: 'Means by which a user gains access at an entrance. The `unmanaged_acs_credential` object, which is not managed by Seam, represents a credential that provides an ACS user access within an access control system. For each acs_credential object, you define the access method. You can also specify additional properties, such as a code.',
+                                        description: 'Means by which an [ACS user](https://docs.seam.co/latest/capability-guides/access-systems/user-management) gains access at an [entrance](https://docs.seam.co/latest/capability-guides/access-systems/retrieving-entrance-details). The `unmanaged_acs_credential` object, which is not managed by Seam, represents a [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) that provides an ACS user access within an [access control system](https://docs.seam.co/latest/capability-guides/access-systems). For each `acs_credential` object, you define the access method. You can also specify additional properties, such as a PIN code.',
                                         properties: {
                                             access_method: {
-                                                description: 'Access method for the credential. Supported values: `code`, `card`, `mobile_key`.',
+                                                description: 'Access method for the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials). Supported values: `code`, `card`, `mobile_key`.',
                                                 enum: ['code', 'card', 'mobile_key'],
                                                 type: 'string',
                                             },
                                             acs_credential_id: {
-                                                description: 'ID of the credential.',
+                                                description: 'ID of the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials).',
                                                 format: 'uuid',
                                                 type: 'string',
                                             },
@@ -3555,17 +3658,17 @@ export default {
                                                 type: 'string',
                                             },
                                             acs_system_id: {
-                                                description: 'ID of the access control system that contains the credential.',
+                                                description: 'ID of the [access control system](https://docs.seam.co/latest/capability-guides/access-systems) that contains the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials).',
                                                 format: 'uuid',
                                                 type: 'string',
                                             },
                                             acs_user_id: {
-                                                description: 'ID of the ACS user to whom the credential belongs.',
+                                                description: 'ID of the [ACS user](https://docs.seam.co/latest/capability-guides/access-systems/user-management) to whom the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) belongs.',
                                                 format: 'uuid',
                                                 type: 'string',
                                             },
                                             assa_abloy_vostio_metadata: {
-                                                description: 'Vostio-specific metadata for the credential.',
+                                                description: 'Vostio-specific metadata for the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials).',
                                                 properties: {
                                                     door_names: {
                                                         items: { type: 'string' },
@@ -3581,28 +3684,32 @@ export default {
                                                 },
                                                 type: 'object',
                                             },
-                                            card_number: { nullable: true, type: 'string' },
+                                            card_number: {
+                                                description: 'Number of the card associated with the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials).',
+                                                nullable: true,
+                                                type: 'string',
+                                            },
                                             code: {
-                                                description: 'Access (PIN) code for the credential.',
+                                                description: 'Access (PIN) code for the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials).',
                                                 nullable: true,
                                                 type: 'string',
                                             },
                                             created_at: {
-                                                description: 'Date and time at which the credential was created.',
+                                                description: 'Date and time at which the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) was created.',
                                                 format: 'date-time',
                                                 type: 'string',
                                             },
                                             display_name: {
-                                                description: 'Display name that corresponds to the credential type.',
+                                                description: 'Display name that corresponds to the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) type.',
                                                 minLength: 1,
                                                 type: 'string',
                                             },
                                             ends_at: {
-                                                description: 'Date and time at which the credential validity ends, in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format. Must be a time in the future and after `starts_at`.',
+                                                description: 'Date and time at which the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) validity ends, in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format. Must be a time in the future and after `starts_at`.',
                                                 type: 'string',
                                             },
                                             errors: {
-                                                description: 'Errors associated with the `acs_credential`.',
+                                                description: 'Errors associated with the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials).',
                                                 items: {
                                                     properties: {
                                                         error_code: { type: 'string' },
@@ -3614,7 +3721,7 @@ export default {
                                                 type: 'array',
                                             },
                                             external_type: {
-                                                description: 'Brand-specific terminology for the credential type. Supported values: `pti_card`, `brivo_credential`, `hid_credential`, `visionline_card`.',
+                                                description: 'Brand-specific terminology for the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) type. Supported values: `pti_card`, `brivo_credential`, `hid_credential`, `visionline_card`.',
                                                 enum: [
                                                     'pti_card',
                                                     'brivo_credential',
@@ -3627,46 +3734,50 @@ export default {
                                                 type: 'string',
                                             },
                                             external_type_display_name: {
-                                                description: 'Display name that corresponds to the brand-specific terminology for the credential type.',
+                                                description: 'Display name that corresponds to the brand-specific terminology for the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) type.',
                                                 type: 'string',
                                             },
-                                            is_issued: { type: 'boolean' },
+                                            is_issued: {
+                                                description: 'Indicates whether the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) has been encoded onto a card.',
+                                                type: 'boolean',
+                                            },
                                             is_latest_desired_state_synced_with_provider: {
-                                                description: 'Indicates whether the latest state of the credential has been synced from Seam to the provider.',
+                                                description: 'Indicates whether the latest state of the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) has been synced from Seam to the provider.',
                                                 nullable: true,
                                                 type: 'boolean',
                                             },
                                             is_managed: { enum: [false], type: 'boolean' },
                                             is_multi_phone_sync_credential: {
-                                                description: 'Indicates whether the credential is a [multi-phone sync credential](https://docs.seam.co/latest/capability-guides/mobile-access-in-development/issuing-mobile-credentials-from-an-access-control-system#what-are-multi-phone-sync-credentials).',
+                                                description: 'Indicates whether the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) is a [multi-phone sync credential](https://docs.seam.co/latest/capability-guides/mobile-access-in-development/issuing-mobile-credentials-from-an-access-control-system#what-are-multi-phone-sync-credentials).',
                                                 type: 'boolean',
                                             },
                                             is_one_time_use: {
-                                                description: 'Indicates whether the credential can only be used once. If "true," the code becomes invalid after the first use.',
+                                                description: 'Indicates whether the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) can only be used once. If `true`, the code becomes invalid after the first use.',
                                                 type: 'boolean',
                                             },
                                             issued_at: {
+                                                description: 'Date and time at which the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) was encoded onto a card.',
                                                 format: 'date-time',
                                                 nullable: true,
                                                 type: 'string',
                                             },
                                             latest_desired_state_synced_with_provider_at: {
-                                                description: 'Date and time at which the state of the credential was most recently synced from Seam to the provider.',
+                                                description: 'Date and time at which the state of the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) was most recently synced from Seam to the provider.',
                                                 format: 'date-time',
                                                 nullable: true,
                                                 type: 'string',
                                             },
                                             parent_acs_credential_id: {
-                                                description: 'ID of the parent credential.',
+                                                description: 'ID of the parent [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials).',
                                                 format: 'uuid',
                                                 type: 'string',
                                             },
                                             starts_at: {
-                                                description: 'Date and time at which the credential validity starts, in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format.',
+                                                description: 'Date and time at which the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) validity starts, in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format.',
                                                 type: 'string',
                                             },
                                             visionline_metadata: {
-                                                description: 'Visionline-specific metadata for the credential.',
+                                                description: 'Visionline-specific metadata for the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials).',
                                                 properties: {
                                                     auto_join: { type: 'boolean' },
                                                     card_function_type: {
@@ -3693,13 +3804,13 @@ export default {
                                                 type: 'object',
                                             },
                                             warnings: {
-                                                description: 'Warnings associated with the `acs_credential`.',
+                                                description: 'Warnings associated with the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials).',
                                                 items: {
-                                                    description: 'Warning associated with the `acs_credential`.',
+                                                    description: 'Warning associated with the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials).',
                                                     discriminator: { propertyName: 'warning_code' },
                                                     oneOf: [
                                                         {
-                                                            description: 'Indicates that the credential is waiting to be issued.',
+                                                            description: 'Indicates that the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) is waiting to be issued.',
                                                             properties: {
                                                                 created_at: {
                                                                     description: 'Date and time at which Seam created the warning.',
@@ -3724,7 +3835,7 @@ export default {
                                                             type: 'object',
                                                         },
                                                         {
-                                                            description: "Indicates that the schedule of one of the credential's children was modified externally.",
+                                                            description: "Indicates that the schedule of one of the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials)'s children was modified externally.",
                                                             properties: {
                                                                 created_at: {
                                                                     description: 'Date and time at which Seam created the warning.',
@@ -3749,7 +3860,7 @@ export default {
                                                             type: 'object',
                                                         },
                                                         {
-                                                            description: 'Indicates that the schedule of this credential was modified to avoid creating a credential with a start date in the past.',
+                                                            description: 'Indicates that the schedule of the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) was modified to avoid creating a credential with a start date in the past.',
                                                             properties: {
                                                                 created_at: {
                                                                     description: 'Date and time at which Seam created the warning.',
@@ -3774,7 +3885,7 @@ export default {
                                                             type: 'object',
                                                         },
                                                         {
-                                                            description: 'Indicates that this credential is being deleted.',
+                                                            description: 'Indicates that the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) is being deleted.',
                                                             properties: {
                                                                 created_at: {
                                                                     description: 'Date and time at which Seam created the warning.',
@@ -3799,7 +3910,7 @@ export default {
                                                             type: 'object',
                                                         },
                                                         {
-                                                            description: 'An unknown issue occurred while syncing the state of this credential with the provider. This issue may affect the proper functioning of this credential.',
+                                                            description: 'An unknown issue occurred while syncing the state of the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) with the provider. This issue may affect the proper functioning of the credential.',
                                                             properties: {
                                                                 created_at: {
                                                                     description: 'Date and time at which Seam created the warning.',
@@ -3824,7 +3935,7 @@ export default {
                                                             type: 'object',
                                                         },
                                                         {
-                                                            description: 'Access permissions for this [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) have changed. [Reissue](https://docs.seam.co/latest/capability-guides/access-systems/working-with-card-encoders-and-scanners/creating-and-encoding-card-based-credentials) (re-encode) this credential. This issue may affect the proper functioning of the credential.',
+                                                            description: 'Access permissions for the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) have changed. [Reissue](https://docs.seam.co/latest/capability-guides/access-systems/working-with-card-encoders-and-scanners/creating-and-encoding-card-based-credentials) (re-encode) the credential. This issue may affect the proper functioning of the credential.',
                                                             properties: {
                                                                 created_at: {
                                                                     description: 'Date and time at which Seam created the warning.',
@@ -3853,7 +3964,7 @@ export default {
                                                 type: 'array',
                                             },
                                             workspace_id: {
-                                                description: 'ID of the [workspace](https://docs.seam.co/latest/core-concepts/workspaces) that contains the credential.',
+                                                description: 'ID of the [workspace](https://docs.seam.co/latest/core-concepts/workspaces) that contains the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials).',
                                                 format: 'uuid',
                                                 type: 'string',
                                             },
@@ -6417,30 +6528,36 @@ export default {
                                                 nullable: true,
                                                 properties: {
                                                     climate_preset_key: {
-                                                        description: 'Key of the [climate preset](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-climate-presets) to use for the thermostat schedule.',
+                                                        description: 'Key of the [climate preset](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-climate-presets) to use for the [thermostat schedule](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-thermostat-schedules).',
                                                         type: 'string',
                                                     },
                                                     created_at: {
-                                                        description: 'Date and time at which the thermostat schedule was created.',
+                                                        description: 'Date and time at which the [thermostat schedule](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-thermostat-schedules) was created.',
                                                         format: 'date-time',
                                                         type: 'string',
                                                     },
                                                     device_id: {
-                                                        description: 'ID of the desired thermostat device.',
+                                                        description: 'ID of the desired [thermostat](https://docs.seam.co/latest/capability-guides/thermostats) device.',
                                                         format: 'uuid',
                                                         type: 'string',
                                                     },
                                                     ends_at: {
-                                                        description: 'Date and time at which the thermostat schedule ends, in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format.',
+                                                        description: 'Date and time at which the [thermostat schedule](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-thermostat-schedules) ends, in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format.',
                                                         format: 'date-time',
                                                         type: 'string',
                                                     },
                                                     errors: {
-                                                        description: 'Array of errors associated with the thermostat schedule. Each error object within the array contains two fields: `error_code` and `message`. `error_code` is a string that uniquely identifies the type of error, enabling quick recognition and categorization of the issue. `message` provides a more detailed description of the error, offering insights into the issue and potentially how to rectify it.',
+                                                        description: 'Errors associated with the [thermostat schedule](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-thermostat-schedules).',
                                                         items: {
                                                             properties: {
-                                                                error_code: { type: 'string' },
-                                                                message: { type: 'string' },
+                                                                error_code: {
+                                                                    description: 'Unique identifier of the type of error. Enables quick recognition and categorization of the issue.',
+                                                                    type: 'string',
+                                                                },
+                                                                message: {
+                                                                    description: 'Detailed description of the error. Provides insights into the issue and potentially how to rectify it.',
+                                                                    type: 'string',
+                                                                },
                                                             },
                                                             required: ['error_code', 'message'],
                                                             type: 'object',
@@ -6448,26 +6565,26 @@ export default {
                                                         type: 'array',
                                                     },
                                                     max_override_period_minutes: {
-                                                        description: "Number of minutes for which a person at the thermostat can change the thermostat's settings after the activation of the scheduled climate preset. See also [Specifying Manual Override Permissions](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-thermostat-schedules#specifying-manual-override-permissions).",
+                                                        description: "Number of minutes for which a person at the thermostat can change the thermostat's settings after the activation of the scheduled [climate preset](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-climate-presets). See also [Specifying Manual Override Permissions](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-thermostat-schedules#specifying-manual-override-permissions).",
                                                         minimum: 0,
                                                         type: 'integer',
                                                     },
                                                     name: {
-                                                        description: 'User-friendly name to identify the thermostat schedule.',
+                                                        description: 'User-friendly name to identify the [thermostat schedule](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-thermostat-schedules).',
                                                         type: 'string',
                                                     },
                                                     starts_at: {
-                                                        description: 'Date and time at which the thermostat schedule starts, in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format.',
+                                                        description: 'Date and time at which the [thermostat schedule](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-thermostat-schedules) starts, in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format.',
                                                         format: 'date-time',
                                                         type: 'string',
                                                     },
                                                     thermostat_schedule_id: {
-                                                        description: 'ID of the thermostat schedule.',
+                                                        description: 'ID of the [thermostat schedule](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-thermostat-schedules).',
                                                         format: 'uuid',
                                                         type: 'string',
                                                     },
                                                     unstable_is_override_allowed: {
-                                                        description: "Indicates whether a person at the thermostat can change the thermostat's settings.",
+                                                        description: "Indicates whether a person at the thermostat can change the thermostat's settings after the [thermostat schedule](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-thermostat-schedules) starts.",
                                                         type: 'boolean',
                                                         'x-undocumented': 'Unstable',
                                                     },
@@ -6489,15 +6606,15 @@ export default {
                                                 items: {
                                                     properties: {
                                                         can_delete: {
-                                                            description: 'Indicates whether this climate preset key can be deleted.',
+                                                            description: 'Indicates whether the [climate preset](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-climate-presets) key can be deleted.',
                                                             type: 'boolean',
                                                         },
                                                         can_edit: {
-                                                            description: 'Indicates whether this climate preset key can be edited.',
+                                                            description: 'Indicates whether the [climate preset](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-climate-presets) key can be edited.',
                                                             type: 'boolean',
                                                         },
                                                         climate_preset_key: {
-                                                            description: 'Unique key to identify the climate preset.',
+                                                            description: 'Unique key to identify the [climate preset](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-climate-presets).',
                                                             type: 'string',
                                                         },
                                                         cooling_set_point_celsius: {
@@ -6506,26 +6623,26 @@ export default {
                                                             type: 'number',
                                                         },
                                                         cooling_set_point_fahrenheit: {
-                                                            description: 'Temperature to which the thermostat should cool (in °F).',
+                                                            description: 'Temperature to which the thermostat should cool (in °F). See also [Set Points](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points).',
                                                             format: 'float',
                                                             type: 'number',
                                                         },
                                                         display_name: {
-                                                            description: 'Display name for the climate preset.',
+                                                            description: 'Display name for the [climate preset](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-climate-presets).',
                                                             type: 'string',
                                                         },
                                                         fan_mode_setting: {
-                                                            description: 'Desired fan mode setting, such as `on`, `auto`, or `circulate`.',
+                                                            description: 'Desired [fan mode setting](https://docs.seam.co/latest/capability-guides/thermostats/configure-current-climate-settings#fan-mode-settings), such as `on`, `auto`, or `circulate`.',
                                                             enum: ['auto', 'on', 'circulate'],
                                                             type: 'string',
                                                         },
                                                         heating_set_point_celsius: {
-                                                            description: 'Temperature to which the thermostat should heat (in °C).',
+                                                            description: 'Temperature to which the thermostat should heat (in °C). See also [Set Points](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points).',
                                                             format: 'float',
                                                             type: 'number',
                                                         },
                                                         heating_set_point_fahrenheit: {
-                                                            description: 'Temperature to which the thermostat should heat (in °F).',
+                                                            description: 'Temperature to which the thermostat should heat (in °F). See also [Set Points](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points).',
                                                             format: 'float',
                                                             type: 'number',
                                                         },
@@ -6536,13 +6653,13 @@ export default {
                                                         },
                                                         manual_override_allowed: {
                                                             deprecated: true,
-                                                            description: "Indicates whether a person at the thermostat can change the thermostat's settings.",
+                                                            description: "Indicates whether a person at the thermostat can change the thermostat's settings. See [Specifying Manual Override Permissions](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-thermostat-schedules#specifying-manual-override-permissions).",
                                                             type: 'boolean',
                                                             'x-deprecated': "Use 'thermostat_schedule.is_override_allowed'",
                                                         },
                                                         name: {
                                                             default: null,
-                                                            description: 'User-friendly name to identify the climate preset.',
+                                                            description: 'User-friendly name to identify the [climate preset](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-climate-presets).',
                                                             nullable: true,
                                                             type: 'string',
                                                         },
@@ -6575,15 +6692,15 @@ export default {
                                             current_climate_setting: {
                                                 properties: {
                                                     can_delete: {
-                                                        description: 'Indicates whether this climate preset key can be deleted.',
+                                                        description: 'Indicates whether the [climate preset](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-climate-presets) key can be deleted.',
                                                         type: 'boolean',
                                                     },
                                                     can_edit: {
-                                                        description: 'Indicates whether this climate preset key can be edited.',
+                                                        description: 'Indicates whether the [climate preset](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-climate-presets) key can be edited.',
                                                         type: 'boolean',
                                                     },
                                                     climate_preset_key: {
-                                                        description: 'Unique key to identify the climate preset.',
+                                                        description: 'Unique key to identify the [climate preset](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-climate-presets).',
                                                         type: 'string',
                                                     },
                                                     cooling_set_point_celsius: {
@@ -6592,26 +6709,26 @@ export default {
                                                         type: 'number',
                                                     },
                                                     cooling_set_point_fahrenheit: {
-                                                        description: 'Temperature to which the thermostat should cool (in °F).',
+                                                        description: 'Temperature to which the thermostat should cool (in °F). See also [Set Points](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points).',
                                                         format: 'float',
                                                         type: 'number',
                                                     },
                                                     display_name: {
-                                                        description: 'Display name for the climate preset.',
+                                                        description: 'Display name for the [climate preset](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-climate-presets).',
                                                         type: 'string',
                                                     },
                                                     fan_mode_setting: {
-                                                        description: 'Desired fan mode setting, such as `on`, `auto`, or `circulate`.',
+                                                        description: 'Desired [fan mode setting](https://docs.seam.co/latest/capability-guides/thermostats/configure-current-climate-settings#fan-mode-settings), such as `on`, `auto`, or `circulate`.',
                                                         enum: ['auto', 'on', 'circulate'],
                                                         type: 'string',
                                                     },
                                                     heating_set_point_celsius: {
-                                                        description: 'Temperature to which the thermostat should heat (in °C).',
+                                                        description: 'Temperature to which the thermostat should heat (in °C). See also [Set Points](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points).',
                                                         format: 'float',
                                                         type: 'number',
                                                     },
                                                     heating_set_point_fahrenheit: {
-                                                        description: 'Temperature to which the thermostat should heat (in °F).',
+                                                        description: 'Temperature to which the thermostat should heat (in °F). See also [Set Points](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points).',
                                                         format: 'float',
                                                         type: 'number',
                                                     },
@@ -6622,13 +6739,13 @@ export default {
                                                     },
                                                     manual_override_allowed: {
                                                         deprecated: true,
-                                                        description: "Indicates whether a person at the thermostat can change the thermostat's settings.",
+                                                        description: "Indicates whether a person at the thermostat can change the thermostat's settings. See [Specifying Manual Override Permissions](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-thermostat-schedules#specifying-manual-override-permissions).",
                                                         type: 'boolean',
                                                         'x-deprecated': "Use 'thermostat_schedule.is_override_allowed'",
                                                     },
                                                     name: {
                                                         default: null,
-                                                        description: 'User-friendly name to identify the climate preset.',
+                                                        description: 'User-friendly name to identify the [climate preset](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-climate-presets).',
                                                         nullable: true,
                                                         type: 'string',
                                                     },
@@ -6639,15 +6756,15 @@ export default {
                                                 deprecated: true,
                                                 properties: {
                                                     can_delete: {
-                                                        description: 'Indicates whether this climate preset key can be deleted.',
+                                                        description: 'Indicates whether the [climate preset](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-climate-presets) key can be deleted.',
                                                         type: 'boolean',
                                                     },
                                                     can_edit: {
-                                                        description: 'Indicates whether this climate preset key can be edited.',
+                                                        description: 'Indicates whether the [climate preset](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-climate-presets) key can be edited.',
                                                         type: 'boolean',
                                                     },
                                                     climate_preset_key: {
-                                                        description: 'Unique key to identify the climate preset.',
+                                                        description: 'Unique key to identify the [climate preset](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-climate-presets).',
                                                         type: 'string',
                                                     },
                                                     cooling_set_point_celsius: {
@@ -6656,26 +6773,26 @@ export default {
                                                         type: 'number',
                                                     },
                                                     cooling_set_point_fahrenheit: {
-                                                        description: 'Temperature to which the thermostat should cool (in °F).',
+                                                        description: 'Temperature to which the thermostat should cool (in °F). See also [Set Points](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points).',
                                                         format: 'float',
                                                         type: 'number',
                                                     },
                                                     display_name: {
-                                                        description: 'Display name for the climate preset.',
+                                                        description: 'Display name for the [climate preset](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-climate-presets).',
                                                         type: 'string',
                                                     },
                                                     fan_mode_setting: {
-                                                        description: 'Desired fan mode setting, such as `on`, `auto`, or `circulate`.',
+                                                        description: 'Desired [fan mode setting](https://docs.seam.co/latest/capability-guides/thermostats/configure-current-climate-settings#fan-mode-settings), such as `on`, `auto`, or `circulate`.',
                                                         enum: ['auto', 'on', 'circulate'],
                                                         type: 'string',
                                                     },
                                                     heating_set_point_celsius: {
-                                                        description: 'Temperature to which the thermostat should heat (in °C).',
+                                                        description: 'Temperature to which the thermostat should heat (in °C). See also [Set Points](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points).',
                                                         format: 'float',
                                                         type: 'number',
                                                     },
                                                     heating_set_point_fahrenheit: {
-                                                        description: 'Temperature to which the thermostat should heat (in °F).',
+                                                        description: 'Temperature to which the thermostat should heat (in °F). See also [Set Points](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points).',
                                                         format: 'float',
                                                         type: 'number',
                                                     },
@@ -6686,13 +6803,13 @@ export default {
                                                     },
                                                     manual_override_allowed: {
                                                         deprecated: true,
-                                                        description: "Indicates whether a person at the thermostat can change the thermostat's settings.",
+                                                        description: "Indicates whether a person at the thermostat can change the thermostat's settings. See [Specifying Manual Override Permissions](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-thermostat-schedules#specifying-manual-override-permissions).",
                                                         type: 'boolean',
                                                         'x-deprecated': "Use 'thermostat_schedule.is_override_allowed'",
                                                     },
                                                     name: {
                                                         default: null,
-                                                        description: 'User-friendly name to identify the climate preset.',
+                                                        description: 'User-friendly name to identify the [climate preset](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-climate-presets).',
                                                         nullable: true,
                                                         type: 'string',
                                                     },
@@ -10739,7 +10856,7 @@ export default {
                                 type: 'number',
                             },
                             cooling_set_point_fahrenheit: {
-                                description: 'Temperature to which the thermostat should cool (in °F).',
+                                description: 'Temperature to which the thermostat should cool (in °F). See also [Set Points](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points).',
                                 format: 'float',
                                 type: 'number',
                             },
@@ -10763,17 +10880,17 @@ export default {
                                 type: 'string',
                             },
                             fan_mode_setting: {
-                                description: 'Desired fan mode setting, such as `on`, `auto`, or `circulate`.',
+                                description: 'Desired [fan mode setting](https://docs.seam.co/latest/capability-guides/thermostats/configure-current-climate-settings#fan-mode-settings), such as `on`, `auto`, or `circulate`.',
                                 enum: ['auto', 'on', 'circulate'],
                                 type: 'string',
                             },
                             heating_set_point_celsius: {
-                                description: 'Temperature to which the thermostat should heat (in °C).',
+                                description: 'Temperature to which the thermostat should heat (in °C). See also [Set Points](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points).',
                                 format: 'float',
                                 type: 'number',
                             },
                             heating_set_point_fahrenheit: {
-                                description: 'Temperature to which the thermostat should heat (in °F).',
+                                description: 'Temperature to which the thermostat should heat (in °F). See also [Set Points](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points).',
                                 format: 'float',
                                 type: 'number',
                             },
@@ -11125,6 +11242,58 @@ export default {
                         type: 'object',
                         'x-route-path': '/thermostats',
                     },
+                    {
+                        description: 'The name of a [device](https://docs.seam.co/latest/core-concepts/devices) was changed.',
+                        properties: {
+                            connected_account_id: {
+                                description: 'ID of the [connected account](https://docs.seam.co/latest/core-concepts/connected-accounts).',
+                                format: 'uuid',
+                                type: 'string',
+                            },
+                            created_at: {
+                                description: 'Date and time at which the event was created.',
+                                format: 'date-time',
+                                type: 'string',
+                            },
+                            device_id: {
+                                description: 'ID of the device.',
+                                format: 'uuid',
+                                type: 'string',
+                            },
+                            event_id: {
+                                description: 'ID of the event.',
+                                format: 'uuid',
+                                type: 'string',
+                            },
+                            event_type: { enum: ['device.name_changed'], type: 'string' },
+                            new_name: {
+                                description: 'The new name of the device.',
+                                type: 'string',
+                            },
+                            occurred_at: {
+                                description: 'Date and time at which the event occurred.',
+                                format: 'date-time',
+                                type: 'string',
+                            },
+                            workspace_id: {
+                                description: 'ID of the [workspace](https://docs.seam.co/latest/core-concepts/workspaces).',
+                                format: 'uuid',
+                                type: 'string',
+                            },
+                        },
+                        required: [
+                            'event_id',
+                            'workspace_id',
+                            'created_at',
+                            'occurred_at',
+                            'device_id',
+                            'connected_account_id',
+                            'event_type',
+                            'new_name',
+                        ],
+                        type: 'object',
+                        'x-route-path': '/devices',
+                    },
                     {
                         description: 'An [enrollment automation](https://docs.seam.co/latest/capability-guides/mobile-access/issuing-mobile-credentials-from-an-access-control-system#prepare-the-phones-for-a-user-identity-to-start-receiving-mobile-credentials-using-an-enrollment-aut) was deleted.',
                         properties: {
@@ -11394,30 +11563,36 @@ export default {
                 description: 'Represents a [thermostat schedule](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-thermostat-schedules) that activates a configured [climate preset](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-climate-presets) on a [thermostat](https://docs.seam.co/latest/capability-guides/thermostats) at a specified starting time and deactivates the climate preset at a specified ending time.',
                 properties: {
                     climate_preset_key: {
-                        description: 'Key of the [climate preset](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-climate-presets) to use for the thermostat schedule.',
+                        description: 'Key of the [climate preset](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-climate-presets) to use for the [thermostat schedule](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-thermostat-schedules).',
                         type: 'string',
                     },
                     created_at: {
-                        description: 'Date and time at which the thermostat schedule was created.',
+                        description: 'Date and time at which the [thermostat schedule](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-thermostat-schedules) was created.',
                         format: 'date-time',
                         type: 'string',
                     },
                     device_id: {
-                        description: 'ID of the desired thermostat device.',
+                        description: 'ID of the desired [thermostat](https://docs.seam.co/latest/capability-guides/thermostats) device.',
                         format: 'uuid',
                         type: 'string',
                     },
                     ends_at: {
-                        description: 'Date and time at which the thermostat schedule ends, in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format.',
+                        description: 'Date and time at which the [thermostat schedule](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-thermostat-schedules) ends, in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format.',
                         format: 'date-time',
                         type: 'string',
                     },
                     errors: {
-                        description: 'Array of errors associated with the thermostat schedule. Each error object within the array contains two fields: `error_code` and `message`. `error_code` is a string that uniquely identifies the type of error, enabling quick recognition and categorization of the issue. `message` provides a more detailed description of the error, offering insights into the issue and potentially how to rectify it.',
+                        description: 'Errors associated with the [thermostat schedule](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-thermostat-schedules).',
                         items: {
                             properties: {
-                                error_code: { type: 'string' },
-                                message: { type: 'string' },
+                                error_code: {
+                                    description: 'Unique identifier of the type of error. Enables quick recognition and categorization of the issue.',
+                                    type: 'string',
+                                },
+                                message: {
+                                    description: 'Detailed description of the error. Provides insights into the issue and potentially how to rectify it.',
+                                    type: 'string',
+                                },
                             },
                             required: ['error_code', 'message'],
                             type: 'object',
@@ -11425,26 +11600,26 @@ export default {
                         type: 'array',
                     },
                     max_override_period_minutes: {
-                        description: "Number of minutes for which a person at the thermostat can change the thermostat's settings after the activation of the scheduled climate preset. See also [Specifying Manual Override Permissions](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-thermostat-schedules#specifying-manual-override-permissions).",
+                        description: "Number of minutes for which a person at the thermostat can change the thermostat's settings after the activation of the scheduled [climate preset](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-climate-presets). See also [Specifying Manual Override Permissions](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-thermostat-schedules#specifying-manual-override-permissions).",
                         minimum: 0,
                         type: 'integer',
                     },
                     name: {
-                        description: 'User-friendly name to identify the thermostat schedule.',
+                        description: 'User-friendly name to identify the [thermostat schedule](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-thermostat-schedules).',
                         type: 'string',
                     },
                     starts_at: {
-                        description: 'Date and time at which the thermostat schedule starts, in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format.',
+                        description: 'Date and time at which the [thermostat schedule](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-thermostat-schedules) starts, in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format.',
                         format: 'date-time',
                         type: 'string',
                     },
                     thermostat_schedule_id: {
-                        description: 'ID of the thermostat schedule.',
+                        description: 'ID of the [thermostat schedule](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-thermostat-schedules).',
                         format: 'uuid',
                         type: 'string',
                     },
                     unstable_is_override_allowed: {
-                        description: "Indicates whether a person at the thermostat can change the thermostat's settings.",
+                        description: "Indicates whether a person at the thermostat can change the thermostat's settings after the [thermostat schedule](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-thermostat-schedules) starts.",
                         type: 'boolean',
                         'x-undocumented': 'Unstable',
                     },
@@ -12351,31 +12526,31 @@ export default {
                 'x-route-path': '/acs/access_groups/unmanaged',
             },
             unmanaged_acs_credential: {
-                description: 'Means by which a user gains access at an entrance. The `unmanaged_acs_credential` object, which is not managed by Seam, represents a credential that provides an ACS user access within an access control system. For each acs_credential object, you define the access method. You can also specify additional properties, such as a code.',
+                description: 'Means by which an [ACS user](https://docs.seam.co/latest/capability-guides/access-systems/user-management) gains access at an [entrance](https://docs.seam.co/latest/capability-guides/access-systems/retrieving-entrance-details). The `unmanaged_acs_credential` object, which is not managed by Seam, represents a [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) that provides an ACS user access within an [access control system](https://docs.seam.co/latest/capability-guides/access-systems). For each `acs_credential` object, you define the access method. You can also specify additional properties, such as a PIN code.',
                 properties: {
                     access_method: {
-                        description: 'Access method for the credential. Supported values: `code`, `card`, `mobile_key`.',
+                        description: 'Access method for the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials). Supported values: `code`, `card`, `mobile_key`.',
                         enum: ['code', 'card', 'mobile_key'],
                         type: 'string',
                     },
                     acs_credential_id: {
-                        description: 'ID of the credential.',
+                        description: 'ID of the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials).',
                         format: 'uuid',
                         type: 'string',
                     },
                     acs_credential_pool_id: { format: 'uuid', type: 'string' },
                     acs_system_id: {
-                        description: 'ID of the access control system that contains the credential.',
+                        description: 'ID of the [access control system](https://docs.seam.co/latest/capability-guides/access-systems) that contains the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials).',
                         format: 'uuid',
                         type: 'string',
                     },
                     acs_user_id: {
-                        description: 'ID of the ACS user to whom the credential belongs.',
+                        description: 'ID of the [ACS user](https://docs.seam.co/latest/capability-guides/access-systems/user-management) to whom the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) belongs.',
                         format: 'uuid',
                         type: 'string',
                     },
                     assa_abloy_vostio_metadata: {
-                        description: 'Vostio-specific metadata for the credential.',
+                        description: 'Vostio-specific metadata for the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials).',
                         properties: {
                             door_names: { items: { type: 'string' }, type: 'array' },
                             endpoint_id: { type: 'string' },
@@ -12388,28 +12563,32 @@ export default {
                         },
                         type: 'object',
                     },
-                    card_number: { nullable: true, type: 'string' },
+                    card_number: {
+                        description: 'Number of the card associated with the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials).',
+                        nullable: true,
+                        type: 'string',
+                    },
                     code: {
-                        description: 'Access (PIN) code for the credential.',
+                        description: 'Access (PIN) code for the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials).',
                         nullable: true,
                         type: 'string',
                     },
                     created_at: {
-                        description: 'Date and time at which the credential was created.',
+                        description: 'Date and time at which the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) was created.',
                         format: 'date-time',
                         type: 'string',
                     },
                     display_name: {
-                        description: 'Display name that corresponds to the credential type.',
+                        description: 'Display name that corresponds to the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) type.',
                         minLength: 1,
                         type: 'string',
                     },
                     ends_at: {
-                        description: 'Date and time at which the credential validity ends, in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format. Must be a time in the future and after `starts_at`.',
+                        description: 'Date and time at which the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) validity ends, in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format. Must be a time in the future and after `starts_at`.',
                         type: 'string',
                     },
                     errors: {
-                        description: 'Errors associated with the `acs_credential`.',
+                        description: 'Errors associated with the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials).',
                         items: {
                             properties: {
                                 error_code: { type: 'string' },
@@ -12421,7 +12600,7 @@ export default {
                         type: 'array',
                     },
                     external_type: {
-                        description: 'Brand-specific terminology for the credential type. Supported values: `pti_card`, `brivo_credential`, `hid_credential`, `visionline_card`.',
+                        description: 'Brand-specific terminology for the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) type. Supported values: `pti_card`, `brivo_credential`, `hid_credential`, `visionline_card`.',
                         enum: [
                             'pti_card',
                             'brivo_credential',
@@ -12434,42 +12613,50 @@ export default {
                         type: 'string',
                     },
                     external_type_display_name: {
-                        description: 'Display name that corresponds to the brand-specific terminology for the credential type.',
+                        description: 'Display name that corresponds to the brand-specific terminology for the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) type.',
                         type: 'string',
                     },
-                    is_issued: { type: 'boolean' },
+                    is_issued: {
+                        description: 'Indicates whether the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) has been encoded onto a card.',
+                        type: 'boolean',
+                    },
                     is_latest_desired_state_synced_with_provider: {
-                        description: 'Indicates whether the latest state of the credential has been synced from Seam to the provider.',
+                        description: 'Indicates whether the latest state of the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) has been synced from Seam to the provider.',
                         nullable: true,
                         type: 'boolean',
                     },
                     is_managed: { enum: [false], type: 'boolean' },
                     is_multi_phone_sync_credential: {
-                        description: 'Indicates whether the credential is a [multi-phone sync credential](https://docs.seam.co/latest/capability-guides/mobile-access-in-development/issuing-mobile-credentials-from-an-access-control-system#what-are-multi-phone-sync-credentials).',
+                        description: 'Indicates whether the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) is a [multi-phone sync credential](https://docs.seam.co/latest/capability-guides/mobile-access-in-development/issuing-mobile-credentials-from-an-access-control-system#what-are-multi-phone-sync-credentials).',
                         type: 'boolean',
                     },
                     is_one_time_use: {
-                        description: 'Indicates whether the credential can only be used once. If "true," the code becomes invalid after the first use.',
+                        description: 'Indicates whether the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) can only be used once. If `true`, the code becomes invalid after the first use.',
                         type: 'boolean',
                     },
-                    issued_at: { format: 'date-time', nullable: true, type: 'string' },
+                    issued_at: {
+                        description: 'Date and time at which the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) was encoded onto a card.',
+                        format: 'date-time',
+                        nullable: true,
+                        type: 'string',
+                    },
                     latest_desired_state_synced_with_provider_at: {
-                        description: 'Date and time at which the state of the credential was most recently synced from Seam to the provider.',
+                        description: 'Date and time at which the state of the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) was most recently synced from Seam to the provider.',
                         format: 'date-time',
                         nullable: true,
                         type: 'string',
                     },
                     parent_acs_credential_id: {
-                        description: 'ID of the parent credential.',
+                        description: 'ID of the parent [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials).',
                         format: 'uuid',
                         type: 'string',
                     },
                     starts_at: {
-                        description: 'Date and time at which the credential validity starts, in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format.',
+                        description: 'Date and time at which the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) validity starts, in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format.',
                         type: 'string',
                     },
                     visionline_metadata: {
-                        description: 'Visionline-specific metadata for the credential.',
+                        description: 'Visionline-specific metadata for the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials).',
                         properties: {
                             auto_join: { type: 'boolean' },
                             card_function_type: { enum: ['guest', 'staff'], type: 'string' },
@@ -12493,13 +12680,13 @@ export default {
                         type: 'object',
                     },
                     warnings: {
-                        description: 'Warnings associated with the `acs_credential`.',
+                        description: 'Warnings associated with the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials).',
                         items: {
-                            description: 'Warning associated with the `acs_credential`.',
+                            description: 'Warning associated with the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials).',
                             discriminator: { propertyName: 'warning_code' },
                             oneOf: [
                                 {
-                                    description: 'Indicates that the credential is waiting to be issued.',
+                                    description: 'Indicates that the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) is waiting to be issued.',
                                     properties: {
                                         created_at: {
                                             description: 'Date and time at which Seam created the warning.',
@@ -12520,7 +12707,7 @@ export default {
                                     type: 'object',
                                 },
                                 {
-                                    description: "Indicates that the schedule of one of the credential's children was modified externally.",
+                                    description: "Indicates that the schedule of one of the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials)'s children was modified externally.",
                                     properties: {
                                         created_at: {
                                             description: 'Date and time at which Seam created the warning.',
@@ -12541,7 +12728,7 @@ export default {
                                     type: 'object',
                                 },
                                 {
-                                    description: 'Indicates that the schedule of this credential was modified to avoid creating a credential with a start date in the past.',
+                                    description: 'Indicates that the schedule of the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) was modified to avoid creating a credential with a start date in the past.',
                                     properties: {
                                         created_at: {
                                             description: 'Date and time at which Seam created the warning.',
@@ -12562,7 +12749,7 @@ export default {
                                     type: 'object',
                                 },
                                 {
-                                    description: 'Indicates that this credential is being deleted.',
+                                    description: 'Indicates that the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) is being deleted.',
                                     properties: {
                                         created_at: {
                                             description: 'Date and time at which Seam created the warning.',
@@ -12583,7 +12770,7 @@ export default {
                                     type: 'object',
                                 },
                                 {
-                                    description: 'An unknown issue occurred while syncing the state of this credential with the provider. This issue may affect the proper functioning of this credential.',
+                                    description: 'An unknown issue occurred while syncing the state of the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) with the provider. This issue may affect the proper functioning of the credential.',
                                     properties: {
                                         created_at: {
                                             description: 'Date and time at which Seam created the warning.',
@@ -12604,7 +12791,7 @@ export default {
                                     type: 'object',
                                 },
                                 {
-                                    description: 'Access permissions for this [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) have changed. [Reissue](https://docs.seam.co/latest/capability-guides/access-systems/working-with-card-encoders-and-scanners/creating-and-encoding-card-based-credentials) (re-encode) this credential. This issue may affect the proper functioning of the credential.',
+                                    description: 'Access permissions for the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) have changed. [Reissue](https://docs.seam.co/latest/capability-guides/access-systems/working-with-card-encoders-and-scanners/creating-and-encoding-card-based-credentials) (re-encode) the credential. This issue may affect the proper functioning of the credential.',
                                     properties: {
                                         created_at: {
                                             description: 'Date and time at which Seam created the warning.',
@@ -12629,7 +12816,7 @@ export default {
                         type: 'array',
                     },
                     workspace_id: {
-                        description: 'ID of the [workspace](https://docs.seam.co/latest/core-concepts/workspaces) that contains the credential.',
+                        description: 'ID of the [workspace](https://docs.seam.co/latest/core-concepts/workspaces) that contains the [credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials).',
                         format: 'uuid',
                         type: 'string',
                     },
@@ -12652,7 +12839,7 @@ export default {
                 description: 'Represents an unmanaged [user](https://docs.seam.co/latest/capability-guides/access-systems/user-management) in an [access control system](https://docs.seam.co/latest/capability-guides/access-systems).',
                 properties: {
                     access_schedule: {
-                        description: "`starts_at` and `ends_at` timestamps for the `acs_user`'s access.",
+                        description: "`starts_at` and `ends_at` timestamps for the [ACS user's](https://docs.seam.co/latest/capability-guides/access-systems/user-management) access.",
                         properties: {
                             ends_at: {
                                 description: "Date and time at which the user's access ends, in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format.",
@@ -12670,22 +12857,22 @@ export default {
                         type: 'object',
                     },
                     acs_system_id: {
-                        description: 'ID of the access control system that contains the `acs_user`.',
+                        description: 'ID of the [access control system](https://docs.seam.co/latest/capability-guides/access-systems) that contains the [ACS user](https://docs.seam.co/latest/capability-guides/access-systems/user-management).',
                         format: 'uuid',
                         type: 'string',
                     },
                     acs_user_id: {
-                        description: 'ID of the `acs_user`.',
+                        description: 'ID of the [ACS user](https://docs.seam.co/latest/capability-guides/access-systems/user-management).',
                         format: 'uuid',
                         type: 'string',
                     },
                     created_at: {
-                        description: 'Date and time at which the `acs_user` was created.',
+                        description: 'Date and time at which the [ACS user](https://docs.seam.co/latest/capability-guides/access-systems/user-management) was created.',
                         format: 'date-time',
                         type: 'string',
                     },
                     display_name: {
-                        description: 'Display name for the `acs_user`.',
+                        description: 'Display name for the [ACS user](https://docs.seam.co/latest/capability-guides/access-systems/user-management).',
                         type: 'string',
                     },
                     email: {
@@ -12695,18 +12882,18 @@ export default {
                         'x-deprecated': 'use email_address.',
                     },
                     email_address: {
-                        description: 'Email address of the `acs_user`.',
+                        description: 'Email address of the [ACS user](https://docs.seam.co/latest/capability-guides/access-systems/user-management).',
                         format: 'email',
                         type: 'string',
                     },
                     errors: {
-                        description: 'Errors associated with the `acs_user`.',
+                        description: 'Errors associated with the [ACS user](https://docs.seam.co/latest/capability-guides/access-systems/user-management).',
                         items: {
-                            description: 'Error associated with the `acs_user`.',
+                            description: 'Errors associated with the [ACS user](https://docs.seam.co/latest/capability-guides/access-systems/user-management).',
                             discriminator: { propertyName: 'error_code' },
                             oneOf: [
                                 {
-                                    description: 'Indicates that the ACS user was deleted from the ACS system outside of Seam.',
+                                    description: 'Indicates that the [ACS user](https://docs.seam.co/latest/capability-guides/access-systems/user-management) was deleted from the [access control system](https://docs.seam.co/latest/capability-guides/access-systems) outside of Seam.',
                                     properties: {
                                         created_at: {
                                             description: 'Date and time at which Seam created the error.',
@@ -12726,7 +12913,7 @@ export default {
                                     type: 'object',
                                 },
                                 {
-                                    description: 'Indicates that the user could not be subscribed on Salto KS because the subscription limit has been exceeded.',
+                                    description: 'Indicates that the [ACS user](https://docs.seam.co/latest/capability-guides/access-systems/user-management) could not be subscribed on Salto KS because the subscription limit has been exceeded.',
                                     properties: {
                                         created_at: {
                                             description: 'Date and time at which Seam created the error.',
@@ -12746,7 +12933,7 @@ export default {
                                     type: 'object',
                                 },
                                 {
-                                    description: "Indicates that the user was not created on the ACS system. This is likely due to an internal unexpected error. Please contact Seam's support if you encounter this.",
+                                    description: 'Indicates that the [ACS user](https://docs.seam.co/latest/capability-guides/access-systems/user-management) was not created on the [access control 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).',
                                     properties: {
                                         created_at: {
                                             description: 'Date and time at which Seam created the error.',
@@ -12766,7 +12953,7 @@ export default {
                                     type: 'object',
                                 },
                                 {
-                                    description: "Indicates that the user was not updated on the ACS system. This is likely due to an internal unexpected error. Please contact Seam's support if you encounter this.",
+                                    description: 'Indicates that the [ACS user](https://docs.seam.co/latest/capability-guides/access-systems/user-management) was not updated on the [access control 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).',
                                     properties: {
                                         created_at: {
                                             description: 'Date and time at which Seam created the error.',
@@ -12786,7 +12973,7 @@ export default {
                                     type: 'object',
                                 },
                                 {
-                                    description: "Indicates that the user was not deleted on the ACS system. This is likely due to an internal unexpected error. Please contact Seam's support if you encounter this.",
+                                    description: 'Indicates that the [ACS user](https://docs.seam.co/latest/capability-guides/access-systems/user-management) was not deleted on the [access control 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).',
                                     properties: {
                                         created_at: {
                                             description: 'Date and time at which Seam created the error.',
@@ -12810,7 +12997,7 @@ export default {
                         type: 'array',
                     },
                     external_type: {
-                        description: 'Brand-specific terminology for the `acs_user` type.',
+                        description: 'Brand-specific terminology for the [ACS user](https://docs.seam.co/latest/capability-guides/access-systems/user-management) type.',
                         enum: [
                             'pti_user',
                             'brivo_user',
@@ -12823,11 +13010,11 @@ export default {
                         type: 'string',
                     },
                     external_type_display_name: {
-                        description: 'Display name that corresponds to the brand-specific terminology for the `acs_user` type.',
+                        description: 'Display name that corresponds to the brand-specific terminology for the [ACS user](https://docs.seam.co/latest/capability-guides/access-systems/user-management) type.',
                         type: 'string',
                     },
                     full_name: {
-                        description: 'Full name of the `acs_user`.',
+                        description: 'Full name of the [ACS user](https://docs.seam.co/latest/capability-guides/access-systems/user-management).',
                         type: 'string',
                     },
                     hid_acs_system_id: { format: 'uuid', type: 'string' },
@@ -12838,7 +13025,7 @@ export default {
                     },
                     is_managed: { enum: [false], type: 'boolean' },
                     is_suspended: {
-                        description: 'Indicates whether the `acs_user` is currently [suspended](https://docs.seam.co/latest/capability-guides/access-systems/user-management/suspending-and-unsuspending-users).',
+                        description: 'Indicates whether the [ACS user](https://docs.seam.co/latest/capability-guides/access-systems/user-management) is currently [suspended](https://docs.seam.co/latest/capability-guides/access-systems/user-management/suspending-and-unsuspending-users).',
                         type: 'boolean',
                     },
                     latest_desired_state_synced_with_provider_at: {
@@ -12848,49 +13035,63 @@ export default {
                         'x-undocumented': 'Only used internally.',
                     },
                     phone_number: {
-                        description: 'Phone number of the `acs_user` in E.164 format (for example, `+15555550100`).',
+                        description: 'Phone number of the [ACS user](https://docs.seam.co/latest/capability-guides/access-systems/user-management) in E.164 format (for example, `+15555550100`).',
                         type: 'string',
                     },
                     user_identity_email_address: {
-                        description: 'Email address of the user identity associated with the `acs_user`.',
+                        description: 'Email address of the user identity associated with the [ACS user](https://docs.seam.co/latest/capability-guides/access-systems/user-management).',
                         nullable: true,
                         type: 'string',
                     },
                     user_identity_full_name: {
-                        description: 'Full name of the user identity associated with the `acs_user`.',
+                        description: 'Full name of the user identity associated with the [ACS user](https://docs.seam.co/latest/capability-guides/access-systems/user-management).',
                         nullable: true,
                         type: 'string',
                     },
                     user_identity_id: {
-                        description: 'ID of the user identity associated with the `acs_user`.',
+                        description: 'ID of the user identity associated with the [ACS user](https://docs.seam.co/latest/capability-guides/access-systems/user-management).',
                         type: 'string',
                     },
                     user_identity_phone_number: {
-                        description: 'Phone number of the user identity associated with the `acs_user` in E.164 format (for example, `+15555550100`).',
+                        description: 'Phone number of the user identity associated with the [ACS user](https://docs.seam.co/latest/capability-guides/access-systems/user-management) in E.164 format (for example, `+15555550100`).',
                         nullable: true,
                         type: 'string',
                     },
                     warnings: {
-                        description: 'Warnings associated with the `acs_user`.',
+                        description: 'Warnings associated with the [ACS user](https://docs.seam.co/latest/capability-guides/access-systems/user-management).',
                         items: {
-                            description: 'Warning associated with the `acs_user`.',
+                            description: 'Warnings associated with the [ACS user](https://docs.seam.co/latest/capability-guides/access-systems/user-management).',
                             discriminator: { propertyName: 'warning_code' },
                             oneOf: [
                                 {
-                                    description: 'Indicates that the user is being deleted from the ACS system. This is a temporary state, and the user will be deleted shortly.',
+                                    description: 'Indicates that the [ACS user](https://docs.seam.co/latest/capability-guides/access-systems/user-management) is being deleted from the [access control system](https://docs.seam.co/latest/capability-guides/access-systems). This is a temporary state, and the ACS user will be deleted shortly.',
                                     properties: {
-                                        created_at: { format: 'date-time', type: 'string' },
-                                        message: { type: 'string' },
+                                        created_at: {
+                                            description: 'Date and time at which Seam created the warning.',
+                                            format: 'date-time',
+                                            type: 'string',
+                                        },
+                                        message: {
+                                            description: 'Detailed description of the warning. Provides insights into the issue and potentially how to rectify it.',
+                                            type: 'string',
+                                        },
                                         warning_code: { enum: ['being_deleted'], type: 'string' },
                                     },
                                     required: ['created_at', 'message', 'warning_code'],
                                     type: 'object',
                                 },
                                 {
-                                    description: 'Indicates that the user is not subscribed on the Salto KS, so they cannot unlock doors or perform any actions. This occur when the their access schedule hasn’t started yet, or if their access schedule has ended, or if the site has reached its limit for active users (subscription slots), or if they have been manually unsubscribed.',
+                                    description: 'Indicates that the [ACS user](https://docs.seam.co/latest/capability-guides/access-systems/user-management) is not subscribed on Salto KS, so they cannot unlock doors or perform any actions. This occurs when the their access schedule hasn’t started yet, if their access schedule has ended, if the site has reached its limit for active users (subscription slots), or if they have been manually unsubscribed.',
                                     properties: {
-                                        created_at: { format: 'date-time', type: 'string' },
-                                        message: { type: 'string' },
+                                        created_at: {
+                                            description: 'Date and time at which Seam created the warning.',
+                                            format: 'date-time',
+                                            type: 'string',
+                                        },
+                                        message: {
+                                            description: 'Detailed description of the warning. Provides insights into the issue and potentially how to rectify it.',
+                                            type: 'string',
+                                        },
                                         warning_code: {
                                             enum: ['salto_ks_user_not_subscribed'],
                                             type: 'string',
@@ -12900,10 +13101,17 @@ export default {
                                     type: 'object',
                                 },
                                 {
-                                    description: 'An unknown issue occurred while syncing the state of this user with the provider. This issue may affect the proper functioning of this user.',
+                                    description: 'An unknown issue occurred while syncing the state of this [ACS user](https://docs.seam.co/latest/capability-guides/access-systems/user-management) with the provider. This issue may affect the proper functioning of this user.',
                                     properties: {
-                                        created_at: { format: 'date-time', type: 'string' },
-                                        message: { type: 'string' },
+                                        created_at: {
+                                            description: 'Date and time at which Seam created the warning.',
+                                            format: 'date-time',
+                                            type: 'string',
+                                        },
+                                        message: {
+                                            description: 'Detailed description of the warning. Provides insights into the issue and potentially how to rectify it.',
+                                            type: 'string',
+                                        },
                                         warning_code: {
                                             enum: ['unknown_issue_with_acs_user'],
                                             type: 'string',
@@ -12917,7 +13125,7 @@ export default {
                         type: 'array',
                     },
                     workspace_id: {
-                        description: 'ID of the [workspace](https://docs.seam.co/latest/core-concepts/workspaces) that contains the `acs_user`.',
+                        description: 'ID of the [workspace](https://docs.seam.co/latest/core-concepts/workspaces) that contains the [ACS user](https://docs.seam.co/latest/capability-guides/access-systems/user-management).',
                         format: 'uuid',
                         type: 'string',
                     },
@@ -17829,7 +18037,7 @@ export default {
                                         'x-deprecated': 'use email_address.',
                                     },
                                     email_address: {
-                                        description: 'Email address of the `acs_user`.',
+                                        description: 'Email address of the [ACS user](https://docs.seam.co/latest/capability-guides/access-systems/user-management).',
                                         format: 'email',
                                         type: 'string',
                                     },
@@ -17838,7 +18046,7 @@ export default {
                                         type: 'string',
                                     },
                                     phone_number: {
-                                        description: 'Phone number of the `acs_user` in E.164 format (for example, `+15555550100`).',
+                                        description: 'Phone number of the [ACS user](https://docs.seam.co/latest/capability-guides/access-systems/user-management) in E.164 format (for example, `+15555550100`).',
                                         type: 'string',
                                     },
                                     user_identity_id: {
@@ -18468,7 +18676,7 @@ export default {
                                         type: 'object',
                                     },
                                     acs_user_id: {
-                                        description: 'ID of the `acs_user`.',
+                                        description: 'ID of the [ACS user](https://docs.seam.co/latest/capability-guides/access-systems/user-management).',
                                         format: 'uuid',
                                         type: 'string',
                                     },
@@ -18479,17 +18687,17 @@ export default {
                                         'x-deprecated': 'use email_address.',
                                     },
                                     email_address: {
-                                        description: 'Email address of the `acs_user`.',
+                                        description: 'Email address of the [ACS user](https://docs.seam.co/latest/capability-guides/access-systems/user-management).',
                                         format: 'email',
                                         type: 'string',
                                     },
                                     full_name: {
-                                        description: 'Full name of the `acs_user`.',
+                                        description: 'Full name of the [ACS user](https://docs.seam.co/latest/capability-guides/access-systems/user-management).',
                                         type: 'string',
                                     },
                                     hid_acs_system_id: { format: 'uuid', type: 'string' },
                                     phone_number: {
-                                        description: 'Phone number of the `acs_user` in E.164 format (for example, `+15555550100`).',
+                                        description: 'Phone number of the [ACS user](https://docs.seam.co/latest/capability-guides/access-systems/user-management) in E.164 format (for example, `+15555550100`).',
                                         type: 'string',
                                     },
                                 },
@@ -18545,7 +18753,7 @@ export default {
                                         type: 'object',
                                     },
                                     acs_user_id: {
-                                        description: 'ID of the `acs_user`.',
+                                        description: 'ID of the [ACS user](https://docs.seam.co/latest/capability-guides/access-systems/user-management).',
                                         format: 'uuid',
                                         type: 'string',
                                     },
@@ -18556,17 +18764,17 @@ export default {
                                         'x-deprecated': 'use email_address.',
                                     },
                                     email_address: {
-                                        description: 'Email address of the `acs_user`.',
+                                        description: 'Email address of the [ACS user](https://docs.seam.co/latest/capability-guides/access-systems/user-management).',
                                         format: 'email',
                                         type: 'string',
                                     },
                                     full_name: {
-                                        description: 'Full name of the `acs_user`.',
+                                        description: 'Full name of the [ACS user](https://docs.seam.co/latest/capability-guides/access-systems/user-management).',
                                         type: 'string',
                                     },
                                     hid_acs_system_id: { format: 'uuid', type: 'string' },
                                     phone_number: {
-                                        description: 'Phone number of the `acs_user` in E.164 format (for example, `+15555550100`).',
+                                        description: 'Phone number of the [ACS user](https://docs.seam.co/latest/capability-guides/access-systems/user-management) in E.164 format (for example, `+15555550100`).',
                                         type: 'string',
                                     },
                                 },
@@ -21110,6 +21318,7 @@ export default {
                                             'thermostat.temperature_threshold_no_longer_exceeded',
                                             'thermostat.temperature_reached_set_point',
                                             'thermostat.temperature_changed',
+                                            'device.name_changed',
                                             'enrollment_automation.deleted',
                                             'phone.deactivated',
                                         ],
@@ -21191,6 +21400,7 @@ export default {
                                                 'thermostat.temperature_threshold_no_longer_exceeded',
                                                 'thermostat.temperature_reached_set_point',
                                                 'thermostat.temperature_changed',
+                                                'device.name_changed',
                                                 'enrollment_automation.deleted',
                                                 'phone.deactivated',
                                             ],
@@ -23252,7 +23462,7 @@ export default {
                             schema: {
                                 properties: {
                                     climate_preset_key: {
-                                        description: 'Unique key to identify the climate preset.',
+                                        description: 'Unique key to identify the [climate preset](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-climate-presets).',
                                         type: 'string',
                                     },
                                     cooling_set_point_celsius: {
@@ -23261,7 +23471,7 @@ export default {
                                         type: 'number',
                                     },
                                     cooling_set_point_fahrenheit: {
-                                        description: 'Temperature to which the thermostat should cool (in °F).',
+                                        description: 'Temperature to which the thermostat should cool (in °F). See also [Set Points](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points).',
                                         format: 'float',
                                         type: 'number',
                                     },
@@ -23271,17 +23481,17 @@ export default {
                                         type: 'string',
                                     },
                                     fan_mode_setting: {
-                                        description: 'Desired fan mode setting, such as `on`, `auto`, or `circulate`.',
+                                        description: 'Desired [fan mode setting](https://docs.seam.co/latest/capability-guides/thermostats/configure-current-climate-settings#fan-mode-settings), such as `on`, `auto`, or `circulate`.',
                                         enum: ['auto', 'on', 'circulate'],
                                         type: 'string',
                                     },
                                     heating_set_point_celsius: {
-                                        description: 'Temperature to which the thermostat should heat (in °C).',
+                                        description: 'Temperature to which the thermostat should heat (in °C). See also [Set Points](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points).',
                                         format: 'float',
                                         type: 'number',
                                     },
                                     heating_set_point_fahrenheit: {
-                                        description: 'Temperature to which the thermostat should heat (in °F).',
+                                        description: 'Temperature to which the thermostat should heat (in °F). See also [Set Points](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points).',
                                         format: 'float',
                                         type: 'number',
                                     },
@@ -23299,7 +23509,7 @@ export default {
                                     },
                                     name: {
                                         default: null,
-                                        description: 'User-friendly name to identify the climate preset.',
+                                        description: 'User-friendly name to identify the [climate preset](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-climate-presets).',
                                         nullable: true,
                                         type: 'string',
                                     },
@@ -25012,7 +25222,7 @@ export default {
                             schema: {
                                 properties: {
                                     climate_preset_key: {
-                                        description: 'Unique key to identify the climate preset.',
+                                        description: 'Unique key to identify the [climate preset](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-climate-presets).',
                                         type: 'string',
                                     },
                                     cooling_set_point_celsius: {
@@ -25021,7 +25231,7 @@ export default {
                                         type: 'number',
                                     },
                                     cooling_set_point_fahrenheit: {
-                                        description: 'Temperature to which the thermostat should cool (in °F).',
+                                        description: 'Temperature to which the thermostat should cool (in °F). See also [Set Points](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points).',
                                         format: 'float',
                                         type: 'number',
                                     },
@@ -25031,17 +25241,17 @@ export default {
                                         type: 'string',
                                     },
                                     fan_mode_setting: {
-                                        description: 'Desired fan mode setting, such as `on`, `auto`, or `circulate`.',
+                                        description: 'Desired [fan mode setting](https://docs.seam.co/latest/capability-guides/thermostats/configure-current-climate-settings#fan-mode-settings), such as `on`, `auto`, or `circulate`.',
                                         enum: ['auto', 'on', 'circulate'],
                                         type: 'string',
                                     },
                                     heating_set_point_celsius: {
-                                        description: 'Temperature to which the thermostat should heat (in °C).',
+                                        description: 'Temperature to which the thermostat should heat (in °C). See also [Set Points](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points).',
                                         format: 'float',
                                         type: 'number',
                                     },
                                     heating_set_point_fahrenheit: {
-                                        description: 'Temperature to which the thermostat should heat (in °F).',
+                                        description: 'Temperature to which the thermostat should heat (in °F). See also [Set Points](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points).',
                                         format: 'float',
                                         type: 'number',
                                     },
@@ -25052,13 +25262,13 @@ export default {
                                     },
                                     manual_override_allowed: {
                                         deprecated: true,
-                                        description: "Indicates whether a person at the thermostat can change the thermostat's settings.",
+                                        description: "Indicates whether a person at the thermostat can change the thermostat's settings. See [Specifying Manual Override Permissions](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-thermostat-schedules#specifying-manual-override-permissions).",
                                         type: 'boolean',
                                         'x-deprecated': "Use 'thermostat_schedule.is_override_allowed'",
                                     },
                                     name: {
                                         default: null,
-                                        description: 'User-friendly name to identify the climate preset.',
+                                        description: 'User-friendly name to identify the [climate preset](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-climate-presets).',
                                         nullable: true,
                                         type: 'string',
                                     },
@@ -25109,7 +25319,7 @@ export default {
                             schema: {
                                 properties: {
                                     climate_preset_key: {
-                                        description: 'Unique key to identify the climate preset.',
+                                        description: 'Unique key to identify the [climate preset](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-climate-presets).',
                                         type: 'string',
                                     },
                                     cooling_set_point_celsius: {
@@ -25118,7 +25328,7 @@ export default {
                                         type: 'number',
                                     },
                                     cooling_set_point_fahrenheit: {
-                                        description: 'Temperature to which the thermostat should cool (in °F).',
+                                        description: 'Temperature to which the thermostat should cool (in °F). See also [Set Points](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points).',
                                         format: 'float',
                                         type: 'number',
                                     },
@@ -25128,17 +25338,17 @@ export default {
                                         type: 'string',
                                     },
                                     fan_mode_setting: {
-                                        description: 'Desired fan mode setting, such as `on`, `auto`, or `circulate`.',
+                                        description: 'Desired [fan mode setting](https://docs.seam.co/latest/capability-guides/thermostats/configure-current-climate-settings#fan-mode-settings), such as `on`, `auto`, or `circulate`.',
                                         enum: ['auto', 'on', 'circulate'],
                                         type: 'string',
                                     },
                                     heating_set_point_celsius: {
-                                        description: 'Temperature to which the thermostat should heat (in °C).',
+                                        description: 'Temperature to which the thermostat should heat (in °C). See also [Set Points](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points).',
                                         format: 'float',
                                         type: 'number',
                                     },
                                     heating_set_point_fahrenheit: {
-                                        description: 'Temperature to which the thermostat should heat (in °F).',
+                                        description: 'Temperature to which the thermostat should heat (in °F). See also [Set Points](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points).',
                                         format: 'float',
                                         type: 'number',
                                     },
@@ -25149,13 +25359,13 @@ export default {
                                     },
                                     manual_override_allowed: {
                                         deprecated: true,
-                                        description: "Indicates whether a person at the thermostat can change the thermostat's settings.",
+                                        description: "Indicates whether a person at the thermostat can change the thermostat's settings. See [Specifying Manual Override Permissions](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-thermostat-schedules#specifying-manual-override-permissions).",
                                         type: 'boolean',
                                         'x-deprecated': "Use 'thermostat_schedule.is_override_allowed'",
                                     },
                                     name: {
                                         default: null,
-                                        description: 'User-friendly name to identify the climate preset.',
+                                        description: 'User-friendly name to identify the [climate preset](https://docs.seam.co/latest/capability-guides/thermostats/creating-and-managing-climate-presets).',
                                         nullable: true,
                                         type: 'string',
                                     },