Skip to content

Commit 755fe22

Browse files
committed
ci: Generate docs
1 parent 7bdf182 commit 755fe22

3 files changed

Lines changed: 43 additions & 28 deletions

File tree

docs/api/acs/credentials/README.md

Lines changed: 10 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -299,13 +299,21 @@ Item format: `Object`
299299

300300
Warnings associated with the [credential](../../../capability-guides/access-systems/managing-credentials.md).
301301

302-
The items in this list are objects. The specific structure of each object depends on the value of its `warning_code` field. Each object will be one of the following variants:
302+
The items in this list are objects. The specific structure of each object depends on the value of its `warning_code` field.
303+
The `warning_code` field can be one of the following values:
304+
- `waiting_to_be_issued`
305+
- `schedule_externally_modified`
306+
- `schedule_modified`
307+
- `being_deleted`
308+
- `unknown_issue_with_acs_credential`
309+
- `needs_to_be_reissued`
310+
311+
Each object will be one of the following variants:
303312
{% tabs %}
304313
{% tab title="waiting_to_be_issued" %}
305314

306315
Indicates that the [credential](../../../capability-guides/access-systems/managing-credentials.md) is waiting to be issued.
307316

308-
Variant Properties:
309317

310318
<details>
311319

@@ -332,7 +340,6 @@ Possible enum values:
332340

333341
Indicates that the schedule of one of the [credential](../../../capability-guides/access-systems/managing-credentials.md)'s children was modified externally.
334342

335-
Variant Properties:
336343

337344
<details>
338345

@@ -359,7 +366,6 @@ Possible enum values:
359366

360367
Indicates that the schedule of the [credential](../../../capability-guides/access-systems/managing-credentials.md) was modified to avoid creating a credential with a start date in the past.
361368

362-
Variant Properties:
363369

364370
<details>
365371

@@ -386,7 +392,6 @@ Possible enum values:
386392

387393
Indicates that the [credential](../../../capability-guides/access-systems/managing-credentials.md) is being deleted.
388394

389-
Variant Properties:
390395

391396
<details>
392397

@@ -413,7 +418,6 @@ Possible enum values:
413418

414419
An unknown issue occurred while syncing the state of the [credential](../../../capability-guides/access-systems/managing-credentials.md) with the provider. This issue may affect the proper functioning of the credential.
415420

416-
Variant Properties:
417421

418422
<details>
419423

@@ -440,7 +444,6 @@ Possible enum values:
440444

441445
Access permissions for the [credential](../../../capability-guides/access-systems/managing-credentials.md) have changed. [Reissue](../../../capability-guides/access-systems/working-with-card-encoders-and-scanners/creating-and-encoding-card-based-credentials.md) (re-encode) the credential. This issue may affect the proper functioning of the credential.
442446

443-
Variant Properties:
444447

445448
<details>
446449

docs/api/acs/systems/README.md

Lines changed: 17 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -106,15 +106,24 @@ Item format: `Object`
106106

107107
Errors associated with the [access control system](https://docs.seam.co/latest/capability-guides/access-systems).
108108

109-
The items in this list are objects. The specific structure of each object depends on the value of its `error_code` field. Each object will be one of the following variants:
109+
The items in this list are objects. The specific structure of each object depends on the value of its `error_code` field.
110+
The `error_code` field can be one of the following values:
111+
- `seam_bridge_disconnected`
112+
- `bridge_disconnected`
113+
- `visionline_instance_unreachable`
114+
- `salto_ks_subscription_limit_exceeded`
115+
- `acs_system_disconnected`
116+
- `account_disconnected`
117+
- `salto_ks_certification_expired`
118+
119+
Each object will be one of the following variants:
110120
{% tabs %}
111121
{% tab title="seam_bridge_disconnected" %}
112122

113123
Indicates that the Seam API cannot communicate with [Seam Bridge](../../../capability-guides/seam-bridge.md), for example, if Seam Bridge executable has stopped or if the computer running the Seam Bridge executable is offline.
114124
This error might also occur if Seam Bridge is connected to the wrong [workspace](../../../core-concepts/workspaces/README.md).
115125
See also [Troubleshooting Your Access Control System](../../../capability-guides/access-systems/troubleshooting-your-access-control-system.md#acs_system.errors.seam_bridge_disconnected).
116126

117-
Variant Properties:
118127

119128
<details>
120129

@@ -142,7 +151,6 @@ Detailed description of the error. Provides insights into the issue and potentia
142151
Indicates that the Seam API cannot communicate with [Seam Bridge](../../../capability-guides/seam-bridge.md), for example, if Seam Bridge executable has stopped or if the computer running the Seam Bridge executable is offline.
143152
See also [Troubleshooting Your Access Control System](../../../capability-guides/access-systems/troubleshooting-your-access-control-system.md#acs_system.errors.seam_bridge_disconnected).
144153

145-
Variant Properties:
146154

147155
<details>
148156

@@ -175,7 +183,6 @@ Indicates that [Seam Bridge](../../../capability-guides/seam-bridge.md) is funct
175183
For example, the IP address of the on-premises access control system may be set incorrectly within the Seam [workspace](../../../core-concepts/workspaces/README.md).
176184
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).
177185

178-
Variant Properties:
179186

180187
<details>
181188

@@ -202,7 +209,6 @@ Detailed description of the error. Provides insights into the issue and potentia
202209

203210
Indicates that the maximum number of users allowed for the site has been reached. This means that new access codes cannot be created. Contact Salto support to increase the user limit.
204211

205-
Variant Properties:
206212

207213
<details>
208214

@@ -229,7 +235,6 @@ Detailed description of the error. Provides insights into the issue and potentia
229235

230236
Indicates that the [access control system](https://docs.seam.co/latest/capability-guides/access-systems) has been disconnected. See [Troubleshooting Your Access Control System](../../../capability-guides/access-systems/troubleshooting-your-access-control-system.md) to resolve the issue.
231237

232-
Variant Properties:
233238

234239
<details>
235240

@@ -256,7 +261,6 @@ Detailed description of the error. Provides insights into the issue and potentia
256261

257262
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.
258263

259-
Variant Properties:
260264

261265
<details>
262266

@@ -283,7 +287,6 @@ Detailed description of the error. Provides insights into the issue and potentia
283287

284288
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.
285289

286-
Variant Properties:
287290

288291
<details>
289292

@@ -456,13 +459,17 @@ Item format: `Object`
456459

457460
Warnings associated with the [access control system](https://docs.seam.co/latest/capability-guides/access-systems).
458461

459-
The items in this list are objects. The specific structure of each object depends on the value of its `warning_code` field. Each object will be one of the following variants:
462+
The items in this list are objects. The specific structure of each object depends on the value of its `warning_code` field.
463+
The `warning_code` field can be one of the following values:
464+
- `salto_ks_subscription_limit_almost_reached`
465+
- `time_zone_does_not_match_location`
466+
467+
Each object will be one of the following variants:
460468
{% tabs %}
461469
{% tab title="salto_ks_subscription_limit_almost_reached" %}
462470

463471
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.
464472

465-
Variant Properties:
466473

467474
<details>
468475

@@ -489,7 +496,6 @@ Possible enum values:
489496

490497
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](../../../capability-guides/access-systems/retrieving-entrance-details.md).
491498

492-
Variant Properties:
493499

494500
<details>
495501

docs/api/acs/users/README.md

Lines changed: 16 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -88,13 +88,20 @@ Item format: `Object`
8888

8989
Errors associated with the [ACS user](https://docs.seam.co/latest/capability-guides/access-systems/user-management).
9090

91-
The items in this list are objects. The specific structure of each object depends on the value of its `error_code` field. Each object will be one of the following variants:
91+
The items in this list are objects. The specific structure of each object depends on the value of its `error_code` field.
92+
The `error_code` field can be one of the following values:
93+
- `deleted_externally`
94+
- `salto_ks_subscription_limit_exceeded`
95+
- `failed_to_create_on_acs_system`
96+
- `failed_to_update_on_acs_system`
97+
- `failed_to_delete_on_acs_system`
98+
99+
Each object will be one of the following variants:
92100
{% tabs %}
93101
{% tab title="deleted_externally" %}
94102

95103
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.
96104

97-
Variant Properties:
98105

99106
<details>
100107

@@ -119,7 +126,6 @@ Detailed description of the error. Provides insights into the issue and potentia
119126

120127
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.
121128

122-
Variant Properties:
123129

124130
<details>
125131

@@ -144,7 +150,6 @@ Detailed description of the error. Provides insights into the issue and potentia
144150

145151
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).
146152

147-
Variant Properties:
148153

149154
<details>
150155

@@ -169,7 +174,6 @@ Detailed description of the error. Provides insights into the issue and potentia
169174

170175
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).
171176

172-
Variant Properties:
173177

174178
<details>
175179

@@ -194,7 +198,6 @@ Detailed description of the error. Provides insights into the issue and potentia
194198

195199
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).
196200

197-
Variant Properties:
198201

199202
<details>
200203

@@ -320,13 +323,18 @@ Item format: `Object`
320323

321324
Warnings associated with the [ACS user](https://docs.seam.co/latest/capability-guides/access-systems/user-management).
322325

323-
The items in this list are objects. The specific structure of each object depends on the value of its `warning_code` field. Each object will be one of the following variants:
326+
The items in this list are objects. The specific structure of each object depends on the value of its `warning_code` field.
327+
The `warning_code` field can be one of the following values:
328+
- `being_deleted`
329+
- `salto_ks_user_not_subscribed`
330+
- `unknown_issue_with_acs_user`
331+
332+
Each object will be one of the following variants:
324333
{% tabs %}
325334
{% tab title="being_deleted" %}
326335

327336
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.
328337

329-
Variant Properties:
330338

331339
<details>
332340

@@ -351,7 +359,6 @@ Possible enum values:
351359

352360
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.
353361

354-
Variant Properties:
355362

356363
<details>
357364

@@ -376,7 +383,6 @@ Possible enum values:
376383

377384
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.
378385

379-
Variant Properties:
380386

381387
<details>
382388

0 commit comments

Comments
 (0)