@seamapi/types 1.195.0 → 1.196.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -372,40 +372,82 @@ export default {
372
372
  type: 'object',
373
373
  },
374
374
  acs_system: {
375
+ description: 'Represents an [access control system](https://docs.seam.co/latest/capability-guides/access-systems).',
375
376
  properties: {
376
- acs_system_id: { format: 'uuid', type: 'string' },
377
- can_add_acs_users_to_acs_access_groups: { type: 'boolean' },
378
- can_automate_enrollment: { type: 'boolean' },
379
- can_create_acs_access_groups: { type: 'boolean' },
380
- can_remove_acs_users_from_acs_access_groups: { type: 'boolean' },
377
+ acs_system_id: {
378
+ description: 'ID of the `acs_system`.',
379
+ format: 'uuid',
380
+ type: 'string',
381
+ },
382
+ can_add_acs_users_to_acs_access_groups: {
383
+ 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).',
384
+ type: 'boolean',
385
+ },
386
+ can_automate_enrollment: {
387
+ 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`.',
388
+ type: 'boolean',
389
+ },
390
+ can_create_acs_access_groups: {
391
+ 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).',
392
+ type: 'boolean',
393
+ },
394
+ can_remove_acs_users_from_acs_access_groups: {
395
+ 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).',
396
+ type: 'boolean',
397
+ },
381
398
  connected_account_ids: {
399
+ description: 'IDs of the [connected accounts](https://docs.seam.co/latest/core-concepts/connected-accounts) associated with the `acs_system`.',
382
400
  items: { format: 'uuid', type: 'string' },
383
401
  type: 'array',
384
402
  },
385
- created_at: { format: 'date-time', type: 'string' },
403
+ created_at: {
404
+ description: 'Date and time at which the `acs_system` was created.',
405
+ format: 'date-time',
406
+ type: 'string',
407
+ },
386
408
  errors: {
409
+ description: 'Errors associated with the `acs_system`.',
387
410
  items: {
411
+ description: 'Error associated with the `acs_system`.',
388
412
  oneOf: [
389
413
  {
414
+ 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).',
390
415
  properties: {
391
- created_at: { format: 'date-time', type: 'string' },
416
+ created_at: {
417
+ description: 'Date and time at which Seam created the error.',
418
+ format: 'date-time',
419
+ type: 'string',
420
+ },
392
421
  error_code: {
422
+ description: 'Unique identifier of the type of error. Enables quick recognition and categorization of the issue.',
393
423
  enum: ['seam_bridge_disconnected'],
394
424
  type: 'string',
395
425
  },
396
- message: { type: 'string' },
426
+ message: {
427
+ description: 'Detailed description of the error. Provides insights into the issue and potentially how to rectify it.',
428
+ type: 'string',
429
+ },
397
430
  },
398
431
  required: ['created_at', 'message', 'error_code'],
399
432
  type: 'object',
400
433
  },
401
434
  {
435
+ 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).',
402
436
  properties: {
403
- created_at: { format: 'date-time', type: 'string' },
437
+ created_at: {
438
+ description: 'Date and time at which Seam created the error.',
439
+ format: 'date-time',
440
+ type: 'string',
441
+ },
404
442
  error_code: {
443
+ description: 'Unique identifier of the type of error. Enables quick recognition and categorization of the issue.',
405
444
  enum: ['visionline_instance_unreachable'],
406
445
  type: 'string',
407
446
  },
408
- message: { type: 'string' },
447
+ message: {
448
+ description: 'Detailed description of the error. Provides insights into the issue and potentially how to rectify it.',
449
+ type: 'string',
450
+ },
409
451
  },
410
452
  required: ['created_at', 'message', 'error_code'],
411
453
  type: 'object',
@@ -415,6 +457,7 @@ export default {
415
457
  type: 'array',
416
458
  },
417
459
  external_type: {
460
+ description: 'Brand-specific terminology for the `acs_system` type.',
418
461
  enum: [
419
462
  'pti_site',
420
463
  'alta_org',
@@ -427,10 +470,19 @@ export default {
427
470
  ],
428
471
  type: 'string',
429
472
  },
430
- external_type_display_name: { type: 'string' },
431
- image_alt_text: { type: 'string' },
432
- image_url: { type: 'string' },
433
- name: { type: 'string' },
473
+ external_type_display_name: {
474
+ description: 'Display name that corresponds to the brand-specific terminology for the `acs_system` type.',
475
+ type: 'string',
476
+ },
477
+ image_alt_text: {
478
+ description: 'Alternative text for the `acs_system` image.',
479
+ type: 'string',
480
+ },
481
+ image_url: {
482
+ description: 'URL for the image that represents the `acs_system`.',
483
+ type: 'string',
484
+ },
485
+ name: { description: 'Name of the `acs_system`.', type: 'string' },
434
486
  system_type: {
435
487
  deprecated: true,
436
488
  enum: [
@@ -444,18 +496,27 @@ export default {
444
496
  'latch_building',
445
497
  ],
446
498
  type: 'string',
447
- 'x-deprecated': 'use external_type',
499
+ 'x-deprecated': 'Use `external_type`.',
448
500
  },
449
501
  system_type_display_name: {
450
502
  deprecated: true,
451
503
  type: 'string',
452
- 'x-deprecated': 'use external_type_display_name',
504
+ 'x-deprecated': 'Use `external_type_display_name`.',
453
505
  },
454
506
  warnings: {
455
- items: { properties: {}, type: 'object' },
507
+ items: {
508
+ description: '\n ---\n undocumented: Currently, no warnings defined for `acs_system`s.\n ---\n ',
509
+ properties: {},
510
+ type: 'object',
511
+ },
456
512
  type: 'array',
513
+ 'x-undocumented': 'Currently, no warnings defined for `acs_system`s.',
514
+ },
515
+ workspace_id: {
516
+ description: 'ID of the [workspace](https://docs.seam.co/latest/core-concepts/workspaces) that contains the `acs_system`.',
517
+ format: 'uuid',
518
+ type: 'string',
457
519
  },
458
- workspace_id: { format: 'uuid', type: 'string' },
459
520
  },
460
521
  required: [
461
522
  'acs_system_id',