@openfilz-sdk/typescript-ee 1.13.4 → 1.14.1

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.
Files changed (122) hide show
  1. package/.openapi-generator/FILES +26 -0
  2. package/.openapi-generator/openfilz-api-generate-typescript-sdk.sha256 +1 -1
  3. package/README.md +33 -2
  4. package/api/metadata-key-controller-api.ts +121 -0
  5. package/api/sharing-policy-api.ts +1471 -0
  6. package/api/team-administration-api.ts +133 -0
  7. package/api.ts +3 -0
  8. package/dist/api/metadata-key-controller-api.d.ts +63 -0
  9. package/dist/api/metadata-key-controller-api.js +125 -0
  10. package/dist/api/sharing-policy-api.d.ts +662 -0
  11. package/dist/api/sharing-policy-api.js +1399 -0
  12. package/dist/api/team-administration-api.d.ts +70 -0
  13. package/dist/api/team-administration-api.js +139 -0
  14. package/dist/api.d.ts +3 -0
  15. package/dist/api.js +3 -0
  16. package/dist/esm/api/metadata-key-controller-api.d.ts +63 -0
  17. package/dist/esm/api/metadata-key-controller-api.js +118 -0
  18. package/dist/esm/api/sharing-policy-api.d.ts +662 -0
  19. package/dist/esm/api/sharing-policy-api.js +1392 -0
  20. package/dist/esm/api/team-administration-api.d.ts +70 -0
  21. package/dist/esm/api/team-administration-api.js +132 -0
  22. package/dist/esm/api.d.ts +3 -0
  23. package/dist/esm/api.js +3 -0
  24. package/dist/esm/models/effective-policy.d.ts +31 -0
  25. package/dist/esm/models/effective-policy.js +24 -0
  26. package/dist/esm/models/enriched-audit-log.d.ts +2 -0
  27. package/dist/esm/models/enriched-audit-log.js +2 -0
  28. package/dist/esm/models/global-policy.d.ts +26 -0
  29. package/dist/esm/models/global-policy.js +19 -0
  30. package/dist/esm/models/index.d.ts +10 -0
  31. package/dist/esm/models/index.js +10 -0
  32. package/dist/esm/models/item.d.ts +1 -7
  33. package/dist/esm/models/metadata-key-suggestion.d.ts +24 -0
  34. package/dist/esm/models/metadata-key-suggestion.js +14 -0
  35. package/dist/esm/models/my-policy.d.ts +30 -0
  36. package/dist/esm/models/my-policy.js +24 -0
  37. package/dist/esm/models/notification-dto.d.ts +1 -0
  38. package/dist/esm/models/notification-dto.js +1 -0
  39. package/dist/esm/models/override-request.d.ts +21 -0
  40. package/dist/esm/models/override-request.js +19 -0
  41. package/dist/esm/models/override-view.d.ts +27 -0
  42. package/dist/esm/models/override-view.js +19 -0
  43. package/dist/esm/models/revoke-request.d.ts +16 -0
  44. package/dist/esm/models/revoke-request.js +14 -0
  45. package/dist/esm/models/revoke-result.d.ts +18 -0
  46. package/dist/esm/models/revoke-result.js +14 -0
  47. package/dist/esm/models/search-by-audit-log-request.d.ts +2 -0
  48. package/dist/esm/models/search-by-audit-log-request.js +2 -0
  49. package/dist/esm/models/search-by-metadata-request.d.ts +1 -1
  50. package/dist/esm/models/share-result-error.d.ts +6 -0
  51. package/dist/esm/models/share-result-error.js +6 -0
  52. package/dist/esm/models/violation.d.ts +41 -0
  53. package/dist/esm/models/violation.js +28 -0
  54. package/dist/esm/models/violations-response.d.ts +17 -0
  55. package/dist/esm/models/violations-response.js +14 -0
  56. package/dist/models/effective-policy.d.ts +31 -0
  57. package/dist/models/effective-policy.js +27 -0
  58. package/dist/models/enriched-audit-log.d.ts +2 -0
  59. package/dist/models/enriched-audit-log.js +2 -0
  60. package/dist/models/global-policy.d.ts +26 -0
  61. package/dist/models/global-policy.js +22 -0
  62. package/dist/models/index.d.ts +10 -0
  63. package/dist/models/index.js +10 -0
  64. package/dist/models/item.d.ts +1 -7
  65. package/dist/models/metadata-key-suggestion.d.ts +24 -0
  66. package/dist/models/metadata-key-suggestion.js +15 -0
  67. package/dist/models/my-policy.d.ts +30 -0
  68. package/dist/models/my-policy.js +27 -0
  69. package/dist/models/notification-dto.d.ts +1 -0
  70. package/dist/models/notification-dto.js +1 -0
  71. package/dist/models/override-request.d.ts +21 -0
  72. package/dist/models/override-request.js +22 -0
  73. package/dist/models/override-view.d.ts +27 -0
  74. package/dist/models/override-view.js +22 -0
  75. package/dist/models/revoke-request.d.ts +16 -0
  76. package/dist/models/revoke-request.js +15 -0
  77. package/dist/models/revoke-result.d.ts +18 -0
  78. package/dist/models/revoke-result.js +15 -0
  79. package/dist/models/search-by-audit-log-request.d.ts +2 -0
  80. package/dist/models/search-by-audit-log-request.js +2 -0
  81. package/dist/models/search-by-metadata-request.d.ts +1 -1
  82. package/dist/models/share-result-error.d.ts +6 -0
  83. package/dist/models/share-result-error.js +6 -0
  84. package/dist/models/violation.d.ts +41 -0
  85. package/dist/models/violation.js +31 -0
  86. package/dist/models/violations-response.d.ts +17 -0
  87. package/dist/models/violations-response.js +15 -0
  88. package/docs/EffectivePolicy.md +28 -0
  89. package/docs/GlobalPolicy.md +30 -0
  90. package/docs/Item.md +2 -14
  91. package/docs/MetadataKeyControllerApi.md +52 -0
  92. package/docs/MetadataKeySuggestion.md +23 -0
  93. package/docs/MyPolicy.md +26 -0
  94. package/docs/OverrideRequest.md +20 -0
  95. package/docs/OverrideView.md +32 -0
  96. package/docs/RevokeRequest.md +22 -0
  97. package/docs/RevokeResult.md +28 -0
  98. package/docs/SearchByMetadataRequest.md +1 -1
  99. package/docs/SharingPolicyApi.md +988 -0
  100. package/docs/TeamAdministrationApi.md +62 -0
  101. package/docs/Violation.md +42 -0
  102. package/docs/ViolationsResponse.md +24 -0
  103. package/graphql/document.graphqls +2 -2
  104. package/graphql/share.graphqls +2 -0
  105. package/models/effective-policy.ts +41 -0
  106. package/models/enriched-audit-log.ts +2 -0
  107. package/models/global-policy.ts +35 -0
  108. package/models/index.ts +10 -0
  109. package/models/item.ts +1 -7
  110. package/models/metadata-key-suggestion.ts +30 -0
  111. package/models/my-policy.ts +40 -0
  112. package/models/notification-dto.ts +1 -0
  113. package/models/override-request.ts +30 -0
  114. package/models/override-view.ts +36 -0
  115. package/models/revoke-request.ts +24 -0
  116. package/models/revoke-result.ts +24 -0
  117. package/models/search-by-audit-log-request.ts +2 -0
  118. package/models/search-by-metadata-request.ts +1 -1
  119. package/models/share-result-error.ts +6 -0
  120. package/models/violation.ts +50 -0
  121. package/models/violations-response.ts +25 -0
  122. package/package.json +1 -1
@@ -0,0 +1,988 @@
1
+ # SharingPolicyApi
2
+
3
+ All URIs are relative to *http://localhost:8081*
4
+
5
+ |Method | HTTP request | Description|
6
+ |------------- | ------------- | -------------|
7
+ |[**adminGetEffectiveSharingPolicy**](#admingeteffectivesharingpolicy) | **GET** /api/v1/admin/sharing-policy/effective/{userId} | A user\'s effective sharing rule and where it comes from (USER, TEAM or GLOBAL)|
8
+ |[**adminGetSharingPolicy**](#admingetsharingpolicy) | **GET** /api/v1/admin/sharing-policy | The global mode, allowed domains, e-Sign switch, locked keys and number of overrides|
9
+ |[**adminGetSharingPolicyRevokeJob**](#admingetsharingpolicyrevokejob) | **GET** /api/v1/admin/sharing-policy/violations/revoke/{jobId} | Progress of a background revocation|
10
+ |[**adminListSharingPolicyOverrides**](#adminlistsharingpolicyoverrides) | **GET** /api/v1/admin/sharing-policy/overrides | Users and teams with their own sharing rule|
11
+ |[**adminListSharingPolicyViolations**](#adminlistsharingpolicyviolations) | **GET** /api/v1/admin/sharing-policy/violations | Existing shares the current policies refuse|
12
+ |[**adminRemoveSharingPolicyOverride**](#adminremovesharingpolicyoverride) | **DELETE** /api/v1/admin/sharing-policy/overrides/{subjectId} | Remove a user\'s or a team\'s own rule (back to their teams\', else the global mode)|
13
+ |[**adminRevokeSharingPolicyViolations**](#adminrevokesharingpolicyviolations) | **POST** /api/v1/admin/sharing-policy/violations/revoke | Revoke shares that break the policy|
14
+ |[**adminSetSharingPolicyGlobal**](#adminsetsharingpolicyglobal) | **PUT** /api/v1/admin/sharing-policy/global | Change the global mode, allowed domains and e-Sign switch|
15
+ |[**adminSetSharingPolicyOverride**](#adminsetsharingpolicyoverride) | **PUT** /api/v1/admin/sharing-policy/overrides/{subjectId} | Set a user\'s or a team\'s sharing rule|
16
+ |[**getEffectiveSharingPolicy**](#geteffectivesharingpolicy) | **GET** /api/v1/users/sharing-policy/effective/{userId} | A user\'s effective sharing rule and where it comes from (USER, TEAM or GLOBAL)|
17
+ |[**getMySharingPolicy**](#getmysharingpolicy) | **GET** /api/v1/users/me/sharing-policy | The caller\'s own sharing rule (for the share dialog)|
18
+ |[**getSharingPolicy**](#getsharingpolicy) | **GET** /api/v1/users/sharing-policy | The global mode, allowed domains, e-Sign switch, locked keys and number of overrides|
19
+ |[**getSharingPolicyRevokeJob**](#getsharingpolicyrevokejob) | **GET** /api/v1/users/sharing-policy/violations/revoke/{jobId} | Progress of a background revocation|
20
+ |[**listSharingPolicyOverrides**](#listsharingpolicyoverrides) | **GET** /api/v1/users/sharing-policy/overrides | Users and teams with their own sharing rule|
21
+ |[**listSharingPolicyViolations**](#listsharingpolicyviolations) | **GET** /api/v1/users/sharing-policy/violations | Existing shares the current policies refuse|
22
+ |[**removeSharingPolicyOverride**](#removesharingpolicyoverride) | **DELETE** /api/v1/users/sharing-policy/overrides/{subjectId} | Remove a user\'s or a team\'s own rule (back to their teams\', else the global mode)|
23
+ |[**revokeSharingPolicyViolations**](#revokesharingpolicyviolations) | **POST** /api/v1/users/sharing-policy/violations/revoke | Revoke shares that break the policy|
24
+ |[**setSharingPolicyGlobal**](#setsharingpolicyglobal) | **PUT** /api/v1/users/sharing-policy/global | Change the global mode, allowed domains and e-Sign switch|
25
+ |[**setSharingPolicyOverride**](#setsharingpolicyoverride) | **PUT** /api/v1/users/sharing-policy/overrides/{subjectId} | Set a user\'s or a team\'s sharing rule|
26
+
27
+ # **adminGetEffectiveSharingPolicy**
28
+ > EffectivePolicy adminGetEffectiveSharingPolicy()
29
+
30
+
31
+ ### Example
32
+
33
+ ```typescript
34
+ import {
35
+ SharingPolicyApi,
36
+ Configuration
37
+ } from '@openfilz-sdk/typescript-ee';
38
+
39
+ const configuration = new Configuration();
40
+ const apiInstance = new SharingPolicyApi(configuration);
41
+
42
+ let userId: string; // (default to undefined)
43
+
44
+ const { status, data } = await apiInstance.adminGetEffectiveSharingPolicy(
45
+ userId
46
+ );
47
+ ```
48
+
49
+ ### Parameters
50
+
51
+ |Name | Type | Description | Notes|
52
+ |------------- | ------------- | ------------- | -------------|
53
+ | **userId** | [**string**] | | defaults to undefined|
54
+
55
+
56
+ ### Return type
57
+
58
+ **EffectivePolicy**
59
+
60
+ ### Authorization
61
+
62
+ [keycloak_auth](../README.md#keycloak_auth)
63
+
64
+ ### HTTP request headers
65
+
66
+ - **Content-Type**: Not defined
67
+ - **Accept**: */*
68
+
69
+
70
+ ### HTTP response details
71
+ | Status code | Description | Response headers |
72
+ |-------------|-------------|------------------|
73
+ |**200** | OK | - |
74
+
75
+ [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
76
+
77
+ # **adminGetSharingPolicy**
78
+ > GlobalPolicy adminGetSharingPolicy()
79
+
80
+
81
+ ### Example
82
+
83
+ ```typescript
84
+ import {
85
+ SharingPolicyApi,
86
+ Configuration
87
+ } from '@openfilz-sdk/typescript-ee';
88
+
89
+ const configuration = new Configuration();
90
+ const apiInstance = new SharingPolicyApi(configuration);
91
+
92
+ const { status, data } = await apiInstance.adminGetSharingPolicy();
93
+ ```
94
+
95
+ ### Parameters
96
+ This endpoint does not have any parameters.
97
+
98
+
99
+ ### Return type
100
+
101
+ **GlobalPolicy**
102
+
103
+ ### Authorization
104
+
105
+ [keycloak_auth](../README.md#keycloak_auth)
106
+
107
+ ### HTTP request headers
108
+
109
+ - **Content-Type**: Not defined
110
+ - **Accept**: */*
111
+
112
+
113
+ ### HTTP response details
114
+ | Status code | Description | Response headers |
115
+ |-------------|-------------|------------------|
116
+ |**200** | OK | - |
117
+
118
+ [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
119
+
120
+ # **adminGetSharingPolicyRevokeJob**
121
+ > RevokeResult adminGetSharingPolicyRevokeJob()
122
+
123
+
124
+ ### Example
125
+
126
+ ```typescript
127
+ import {
128
+ SharingPolicyApi,
129
+ Configuration
130
+ } from '@openfilz-sdk/typescript-ee';
131
+
132
+ const configuration = new Configuration();
133
+ const apiInstance = new SharingPolicyApi(configuration);
134
+
135
+ let jobId: string; // (default to undefined)
136
+
137
+ const { status, data } = await apiInstance.adminGetSharingPolicyRevokeJob(
138
+ jobId
139
+ );
140
+ ```
141
+
142
+ ### Parameters
143
+
144
+ |Name | Type | Description | Notes|
145
+ |------------- | ------------- | ------------- | -------------|
146
+ | **jobId** | [**string**] | | defaults to undefined|
147
+
148
+
149
+ ### Return type
150
+
151
+ **RevokeResult**
152
+
153
+ ### Authorization
154
+
155
+ [keycloak_auth](../README.md#keycloak_auth)
156
+
157
+ ### HTTP request headers
158
+
159
+ - **Content-Type**: Not defined
160
+ - **Accept**: */*
161
+
162
+
163
+ ### HTTP response details
164
+ | Status code | Description | Response headers |
165
+ |-------------|-------------|------------------|
166
+ |**200** | OK | - |
167
+
168
+ [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
169
+
170
+ # **adminListSharingPolicyOverrides**
171
+ > Array<OverrideView> adminListSharingPolicyOverrides()
172
+
173
+
174
+ ### Example
175
+
176
+ ```typescript
177
+ import {
178
+ SharingPolicyApi,
179
+ Configuration
180
+ } from '@openfilz-sdk/typescript-ee';
181
+
182
+ const configuration = new Configuration();
183
+ const apiInstance = new SharingPolicyApi(configuration);
184
+
185
+ let type: string; // (optional) (default to undefined)
186
+
187
+ const { status, data } = await apiInstance.adminListSharingPolicyOverrides(
188
+ type
189
+ );
190
+ ```
191
+
192
+ ### Parameters
193
+
194
+ |Name | Type | Description | Notes|
195
+ |------------- | ------------- | ------------- | -------------|
196
+ | **type** | [**string**] | | (optional) defaults to undefined|
197
+
198
+
199
+ ### Return type
200
+
201
+ **Array<OverrideView>**
202
+
203
+ ### Authorization
204
+
205
+ [keycloak_auth](../README.md#keycloak_auth)
206
+
207
+ ### HTTP request headers
208
+
209
+ - **Content-Type**: Not defined
210
+ - **Accept**: */*
211
+
212
+
213
+ ### HTTP response details
214
+ | Status code | Description | Response headers |
215
+ |-------------|-------------|------------------|
216
+ |**200** | OK | - |
217
+
218
+ [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
219
+
220
+ # **adminListSharingPolicyViolations**
221
+ > ViolationsResponse adminListSharingPolicyViolations()
222
+
223
+ Keyset-paginated (pass nextCursor back as cursor). A document\'s name is given only when the caller can already read it. count=true answers {count} only (cached 60 s).
224
+
225
+ ### Example
226
+
227
+ ```typescript
228
+ import {
229
+ SharingPolicyApi,
230
+ Configuration
231
+ } from '@openfilz-sdk/typescript-ee';
232
+
233
+ const configuration = new Configuration();
234
+ const apiInstance = new SharingPolicyApi(configuration);
235
+
236
+ let cursor: string; // (optional) (default to undefined)
237
+ let size: number; // (optional) (default to 50)
238
+ let count: boolean; // (optional) (default to false)
239
+
240
+ const { status, data } = await apiInstance.adminListSharingPolicyViolations(
241
+ cursor,
242
+ size,
243
+ count
244
+ );
245
+ ```
246
+
247
+ ### Parameters
248
+
249
+ |Name | Type | Description | Notes|
250
+ |------------- | ------------- | ------------- | -------------|
251
+ | **cursor** | [**string**] | | (optional) defaults to undefined|
252
+ | **size** | [**number**] | | (optional) defaults to 50|
253
+ | **count** | [**boolean**] | | (optional) defaults to false|
254
+
255
+
256
+ ### Return type
257
+
258
+ **ViolationsResponse**
259
+
260
+ ### Authorization
261
+
262
+ [keycloak_auth](../README.md#keycloak_auth)
263
+
264
+ ### HTTP request headers
265
+
266
+ - **Content-Type**: Not defined
267
+ - **Accept**: */*
268
+
269
+
270
+ ### HTTP response details
271
+ | Status code | Description | Response headers |
272
+ |-------------|-------------|------------------|
273
+ |**200** | OK | - |
274
+
275
+ [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
276
+
277
+ # **adminRemoveSharingPolicyOverride**
278
+ > adminRemoveSharingPolicyOverride()
279
+
280
+
281
+ ### Example
282
+
283
+ ```typescript
284
+ import {
285
+ SharingPolicyApi,
286
+ Configuration
287
+ } from '@openfilz-sdk/typescript-ee';
288
+
289
+ const configuration = new Configuration();
290
+ const apiInstance = new SharingPolicyApi(configuration);
291
+
292
+ let subjectId: string; // (default to undefined)
293
+
294
+ const { status, data } = await apiInstance.adminRemoveSharingPolicyOverride(
295
+ subjectId
296
+ );
297
+ ```
298
+
299
+ ### Parameters
300
+
301
+ |Name | Type | Description | Notes|
302
+ |------------- | ------------- | ------------- | -------------|
303
+ | **subjectId** | [**string**] | | defaults to undefined|
304
+
305
+
306
+ ### Return type
307
+
308
+ void (empty response body)
309
+
310
+ ### Authorization
311
+
312
+ [keycloak_auth](../README.md#keycloak_auth)
313
+
314
+ ### HTTP request headers
315
+
316
+ - **Content-Type**: Not defined
317
+ - **Accept**: Not defined
318
+
319
+
320
+ ### HTTP response details
321
+ | Status code | Description | Response headers |
322
+ |-------------|-------------|------------------|
323
+ |**200** | OK | - |
324
+
325
+ [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
326
+
327
+ # **adminRevokeSharingPolicyViolations**
328
+ > RevokeResult adminRevokeSharingPolicyViolations(revokeRequest)
329
+
330
+ items: the rows to revoke (each re-checked; a row that complies is skipped), or all=true. Each revocation is audited under the caller and notified to the document\'s owner. Above 500 rows, all=true runs in the background: 202 with a jobId to poll.
331
+
332
+ ### Example
333
+
334
+ ```typescript
335
+ import {
336
+ SharingPolicyApi,
337
+ Configuration,
338
+ RevokeRequest
339
+ } from '@openfilz-sdk/typescript-ee';
340
+
341
+ const configuration = new Configuration();
342
+ const apiInstance = new SharingPolicyApi(configuration);
343
+
344
+ let revokeRequest: RevokeRequest; //
345
+
346
+ const { status, data } = await apiInstance.adminRevokeSharingPolicyViolations(
347
+ revokeRequest
348
+ );
349
+ ```
350
+
351
+ ### Parameters
352
+
353
+ |Name | Type | Description | Notes|
354
+ |------------- | ------------- | ------------- | -------------|
355
+ | **revokeRequest** | **RevokeRequest**| | |
356
+
357
+
358
+ ### Return type
359
+
360
+ **RevokeResult**
361
+
362
+ ### Authorization
363
+
364
+ [keycloak_auth](../README.md#keycloak_auth)
365
+
366
+ ### HTTP request headers
367
+
368
+ - **Content-Type**: application/json
369
+ - **Accept**: */*
370
+
371
+
372
+ ### HTTP response details
373
+ | Status code | Description | Response headers |
374
+ |-------------|-------------|------------------|
375
+ |**200** | OK | - |
376
+
377
+ [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
378
+
379
+ # **adminSetSharingPolicyGlobal**
380
+ > GlobalPolicy adminSetSharingPolicyGlobal(globalPolicy)
381
+
382
+ Writes only the three openfilz.sharing.external.* settings (audited ADMIN_SETTING_CHANGED; 409 when the deployment locks one). A DOMAIN mode needs at least one domain. The answer carries the number of existing shares that no longer comply (violations).
383
+
384
+ ### Example
385
+
386
+ ```typescript
387
+ import {
388
+ SharingPolicyApi,
389
+ Configuration,
390
+ GlobalPolicy
391
+ } from '@openfilz-sdk/typescript-ee';
392
+
393
+ const configuration = new Configuration();
394
+ const apiInstance = new SharingPolicyApi(configuration);
395
+
396
+ let globalPolicy: GlobalPolicy; //
397
+
398
+ const { status, data } = await apiInstance.adminSetSharingPolicyGlobal(
399
+ globalPolicy
400
+ );
401
+ ```
402
+
403
+ ### Parameters
404
+
405
+ |Name | Type | Description | Notes|
406
+ |------------- | ------------- | ------------- | -------------|
407
+ | **globalPolicy** | **GlobalPolicy**| | |
408
+
409
+
410
+ ### Return type
411
+
412
+ **GlobalPolicy**
413
+
414
+ ### Authorization
415
+
416
+ [keycloak_auth](../README.md#keycloak_auth)
417
+
418
+ ### HTTP request headers
419
+
420
+ - **Content-Type**: application/json
421
+ - **Accept**: */*
422
+
423
+
424
+ ### HTTP response details
425
+ | Status code | Description | Response headers |
426
+ |-------------|-------------|------------------|
427
+ |**200** | OK | - |
428
+
429
+ [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
430
+
431
+ # **adminSetSharingPolicyOverride**
432
+ > OverrideView adminSetSharingPolicyOverride(overrideRequest)
433
+
434
+ A user\'s rule wins over their teams\'; several teams combine by union of their conditions; ALLOW on a team exempts its members from the global mode. Audited SHARING_POLICY_CHANGED. 404 outside the caller\'s organisation.
435
+
436
+ ### Example
437
+
438
+ ```typescript
439
+ import {
440
+ SharingPolicyApi,
441
+ Configuration,
442
+ OverrideRequest
443
+ } from '@openfilz-sdk/typescript-ee';
444
+
445
+ const configuration = new Configuration();
446
+ const apiInstance = new SharingPolicyApi(configuration);
447
+
448
+ let subjectId: string; // (default to undefined)
449
+ let overrideRequest: OverrideRequest; //
450
+
451
+ const { status, data } = await apiInstance.adminSetSharingPolicyOverride(
452
+ subjectId,
453
+ overrideRequest
454
+ );
455
+ ```
456
+
457
+ ### Parameters
458
+
459
+ |Name | Type | Description | Notes|
460
+ |------------- | ------------- | ------------- | -------------|
461
+ | **overrideRequest** | **OverrideRequest**| | |
462
+ | **subjectId** | [**string**] | | defaults to undefined|
463
+
464
+
465
+ ### Return type
466
+
467
+ **OverrideView**
468
+
469
+ ### Authorization
470
+
471
+ [keycloak_auth](../README.md#keycloak_auth)
472
+
473
+ ### HTTP request headers
474
+
475
+ - **Content-Type**: application/json
476
+ - **Accept**: */*
477
+
478
+
479
+ ### HTTP response details
480
+ | Status code | Description | Response headers |
481
+ |-------------|-------------|------------------|
482
+ |**200** | OK | - |
483
+
484
+ [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
485
+
486
+ # **getEffectiveSharingPolicy**
487
+ > EffectivePolicy getEffectiveSharingPolicy()
488
+
489
+
490
+ ### Example
491
+
492
+ ```typescript
493
+ import {
494
+ SharingPolicyApi,
495
+ Configuration
496
+ } from '@openfilz-sdk/typescript-ee';
497
+
498
+ const configuration = new Configuration();
499
+ const apiInstance = new SharingPolicyApi(configuration);
500
+
501
+ let userId: string; // (default to undefined)
502
+
503
+ const { status, data } = await apiInstance.getEffectiveSharingPolicy(
504
+ userId
505
+ );
506
+ ```
507
+
508
+ ### Parameters
509
+
510
+ |Name | Type | Description | Notes|
511
+ |------------- | ------------- | ------------- | -------------|
512
+ | **userId** | [**string**] | | defaults to undefined|
513
+
514
+
515
+ ### Return type
516
+
517
+ **EffectivePolicy**
518
+
519
+ ### Authorization
520
+
521
+ [keycloak_auth](../README.md#keycloak_auth)
522
+
523
+ ### HTTP request headers
524
+
525
+ - **Content-Type**: Not defined
526
+ - **Accept**: */*
527
+
528
+
529
+ ### HTTP response details
530
+ | Status code | Description | Response headers |
531
+ |-------------|-------------|------------------|
532
+ |**200** | OK | - |
533
+
534
+ [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
535
+
536
+ # **getMySharingPolicy**
537
+ > MyPolicy getMySharingPolicy()
538
+
539
+ The allowed domains are listed only when the rule restricts domains.
540
+
541
+ ### Example
542
+
543
+ ```typescript
544
+ import {
545
+ SharingPolicyApi,
546
+ Configuration
547
+ } from '@openfilz-sdk/typescript-ee';
548
+
549
+ const configuration = new Configuration();
550
+ const apiInstance = new SharingPolicyApi(configuration);
551
+
552
+ const { status, data } = await apiInstance.getMySharingPolicy();
553
+ ```
554
+
555
+ ### Parameters
556
+ This endpoint does not have any parameters.
557
+
558
+
559
+ ### Return type
560
+
561
+ **MyPolicy**
562
+
563
+ ### Authorization
564
+
565
+ [keycloak_auth](../README.md#keycloak_auth)
566
+
567
+ ### HTTP request headers
568
+
569
+ - **Content-Type**: Not defined
570
+ - **Accept**: */*
571
+
572
+
573
+ ### HTTP response details
574
+ | Status code | Description | Response headers |
575
+ |-------------|-------------|------------------|
576
+ |**200** | OK | - |
577
+
578
+ [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
579
+
580
+ # **getSharingPolicy**
581
+ > GlobalPolicy getSharingPolicy()
582
+
583
+
584
+ ### Example
585
+
586
+ ```typescript
587
+ import {
588
+ SharingPolicyApi,
589
+ Configuration
590
+ } from '@openfilz-sdk/typescript-ee';
591
+
592
+ const configuration = new Configuration();
593
+ const apiInstance = new SharingPolicyApi(configuration);
594
+
595
+ const { status, data } = await apiInstance.getSharingPolicy();
596
+ ```
597
+
598
+ ### Parameters
599
+ This endpoint does not have any parameters.
600
+
601
+
602
+ ### Return type
603
+
604
+ **GlobalPolicy**
605
+
606
+ ### Authorization
607
+
608
+ [keycloak_auth](../README.md#keycloak_auth)
609
+
610
+ ### HTTP request headers
611
+
612
+ - **Content-Type**: Not defined
613
+ - **Accept**: */*
614
+
615
+
616
+ ### HTTP response details
617
+ | Status code | Description | Response headers |
618
+ |-------------|-------------|------------------|
619
+ |**200** | OK | - |
620
+
621
+ [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
622
+
623
+ # **getSharingPolicyRevokeJob**
624
+ > RevokeResult getSharingPolicyRevokeJob()
625
+
626
+
627
+ ### Example
628
+
629
+ ```typescript
630
+ import {
631
+ SharingPolicyApi,
632
+ Configuration
633
+ } from '@openfilz-sdk/typescript-ee';
634
+
635
+ const configuration = new Configuration();
636
+ const apiInstance = new SharingPolicyApi(configuration);
637
+
638
+ let jobId: string; // (default to undefined)
639
+
640
+ const { status, data } = await apiInstance.getSharingPolicyRevokeJob(
641
+ jobId
642
+ );
643
+ ```
644
+
645
+ ### Parameters
646
+
647
+ |Name | Type | Description | Notes|
648
+ |------------- | ------------- | ------------- | -------------|
649
+ | **jobId** | [**string**] | | defaults to undefined|
650
+
651
+
652
+ ### Return type
653
+
654
+ **RevokeResult**
655
+
656
+ ### Authorization
657
+
658
+ [keycloak_auth](../README.md#keycloak_auth)
659
+
660
+ ### HTTP request headers
661
+
662
+ - **Content-Type**: Not defined
663
+ - **Accept**: */*
664
+
665
+
666
+ ### HTTP response details
667
+ | Status code | Description | Response headers |
668
+ |-------------|-------------|------------------|
669
+ |**200** | OK | - |
670
+
671
+ [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
672
+
673
+ # **listSharingPolicyOverrides**
674
+ > Array<OverrideView> listSharingPolicyOverrides()
675
+
676
+
677
+ ### Example
678
+
679
+ ```typescript
680
+ import {
681
+ SharingPolicyApi,
682
+ Configuration
683
+ } from '@openfilz-sdk/typescript-ee';
684
+
685
+ const configuration = new Configuration();
686
+ const apiInstance = new SharingPolicyApi(configuration);
687
+
688
+ let type: string; // (optional) (default to undefined)
689
+
690
+ const { status, data } = await apiInstance.listSharingPolicyOverrides(
691
+ type
692
+ );
693
+ ```
694
+
695
+ ### Parameters
696
+
697
+ |Name | Type | Description | Notes|
698
+ |------------- | ------------- | ------------- | -------------|
699
+ | **type** | [**string**] | | (optional) defaults to undefined|
700
+
701
+
702
+ ### Return type
703
+
704
+ **Array<OverrideView>**
705
+
706
+ ### Authorization
707
+
708
+ [keycloak_auth](../README.md#keycloak_auth)
709
+
710
+ ### HTTP request headers
711
+
712
+ - **Content-Type**: Not defined
713
+ - **Accept**: */*
714
+
715
+
716
+ ### HTTP response details
717
+ | Status code | Description | Response headers |
718
+ |-------------|-------------|------------------|
719
+ |**200** | OK | - |
720
+
721
+ [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
722
+
723
+ # **listSharingPolicyViolations**
724
+ > ViolationsResponse listSharingPolicyViolations()
725
+
726
+ Keyset-paginated (pass nextCursor back as cursor). A document\'s name is given only when the caller can already read it. count=true answers {count} only (cached 60 s).
727
+
728
+ ### Example
729
+
730
+ ```typescript
731
+ import {
732
+ SharingPolicyApi,
733
+ Configuration
734
+ } from '@openfilz-sdk/typescript-ee';
735
+
736
+ const configuration = new Configuration();
737
+ const apiInstance = new SharingPolicyApi(configuration);
738
+
739
+ let cursor: string; // (optional) (default to undefined)
740
+ let size: number; // (optional) (default to 50)
741
+ let count: boolean; // (optional) (default to false)
742
+
743
+ const { status, data } = await apiInstance.listSharingPolicyViolations(
744
+ cursor,
745
+ size,
746
+ count
747
+ );
748
+ ```
749
+
750
+ ### Parameters
751
+
752
+ |Name | Type | Description | Notes|
753
+ |------------- | ------------- | ------------- | -------------|
754
+ | **cursor** | [**string**] | | (optional) defaults to undefined|
755
+ | **size** | [**number**] | | (optional) defaults to 50|
756
+ | **count** | [**boolean**] | | (optional) defaults to false|
757
+
758
+
759
+ ### Return type
760
+
761
+ **ViolationsResponse**
762
+
763
+ ### Authorization
764
+
765
+ [keycloak_auth](../README.md#keycloak_auth)
766
+
767
+ ### HTTP request headers
768
+
769
+ - **Content-Type**: Not defined
770
+ - **Accept**: */*
771
+
772
+
773
+ ### HTTP response details
774
+ | Status code | Description | Response headers |
775
+ |-------------|-------------|------------------|
776
+ |**200** | OK | - |
777
+
778
+ [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
779
+
780
+ # **removeSharingPolicyOverride**
781
+ > removeSharingPolicyOverride()
782
+
783
+
784
+ ### Example
785
+
786
+ ```typescript
787
+ import {
788
+ SharingPolicyApi,
789
+ Configuration
790
+ } from '@openfilz-sdk/typescript-ee';
791
+
792
+ const configuration = new Configuration();
793
+ const apiInstance = new SharingPolicyApi(configuration);
794
+
795
+ let subjectId: string; // (default to undefined)
796
+
797
+ const { status, data } = await apiInstance.removeSharingPolicyOverride(
798
+ subjectId
799
+ );
800
+ ```
801
+
802
+ ### Parameters
803
+
804
+ |Name | Type | Description | Notes|
805
+ |------------- | ------------- | ------------- | -------------|
806
+ | **subjectId** | [**string**] | | defaults to undefined|
807
+
808
+
809
+ ### Return type
810
+
811
+ void (empty response body)
812
+
813
+ ### Authorization
814
+
815
+ [keycloak_auth](../README.md#keycloak_auth)
816
+
817
+ ### HTTP request headers
818
+
819
+ - **Content-Type**: Not defined
820
+ - **Accept**: Not defined
821
+
822
+
823
+ ### HTTP response details
824
+ | Status code | Description | Response headers |
825
+ |-------------|-------------|------------------|
826
+ |**200** | OK | - |
827
+
828
+ [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
829
+
830
+ # **revokeSharingPolicyViolations**
831
+ > RevokeResult revokeSharingPolicyViolations(revokeRequest)
832
+
833
+ items: the rows to revoke (each re-checked; a row that complies is skipped), or all=true. Each revocation is audited under the caller and notified to the document\'s owner. Above 500 rows, all=true runs in the background: 202 with a jobId to poll.
834
+
835
+ ### Example
836
+
837
+ ```typescript
838
+ import {
839
+ SharingPolicyApi,
840
+ Configuration,
841
+ RevokeRequest
842
+ } from '@openfilz-sdk/typescript-ee';
843
+
844
+ const configuration = new Configuration();
845
+ const apiInstance = new SharingPolicyApi(configuration);
846
+
847
+ let revokeRequest: RevokeRequest; //
848
+
849
+ const { status, data } = await apiInstance.revokeSharingPolicyViolations(
850
+ revokeRequest
851
+ );
852
+ ```
853
+
854
+ ### Parameters
855
+
856
+ |Name | Type | Description | Notes|
857
+ |------------- | ------------- | ------------- | -------------|
858
+ | **revokeRequest** | **RevokeRequest**| | |
859
+
860
+
861
+ ### Return type
862
+
863
+ **RevokeResult**
864
+
865
+ ### Authorization
866
+
867
+ [keycloak_auth](../README.md#keycloak_auth)
868
+
869
+ ### HTTP request headers
870
+
871
+ - **Content-Type**: application/json
872
+ - **Accept**: */*
873
+
874
+
875
+ ### HTTP response details
876
+ | Status code | Description | Response headers |
877
+ |-------------|-------------|------------------|
878
+ |**200** | OK | - |
879
+
880
+ [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
881
+
882
+ # **setSharingPolicyGlobal**
883
+ > GlobalPolicy setSharingPolicyGlobal(globalPolicy)
884
+
885
+ Writes only the three openfilz.sharing.external.* settings (audited ADMIN_SETTING_CHANGED; 409 when the deployment locks one). A DOMAIN mode needs at least one domain. The answer carries the number of existing shares that no longer comply (violations).
886
+
887
+ ### Example
888
+
889
+ ```typescript
890
+ import {
891
+ SharingPolicyApi,
892
+ Configuration,
893
+ GlobalPolicy
894
+ } from '@openfilz-sdk/typescript-ee';
895
+
896
+ const configuration = new Configuration();
897
+ const apiInstance = new SharingPolicyApi(configuration);
898
+
899
+ let globalPolicy: GlobalPolicy; //
900
+
901
+ const { status, data } = await apiInstance.setSharingPolicyGlobal(
902
+ globalPolicy
903
+ );
904
+ ```
905
+
906
+ ### Parameters
907
+
908
+ |Name | Type | Description | Notes|
909
+ |------------- | ------------- | ------------- | -------------|
910
+ | **globalPolicy** | **GlobalPolicy**| | |
911
+
912
+
913
+ ### Return type
914
+
915
+ **GlobalPolicy**
916
+
917
+ ### Authorization
918
+
919
+ [keycloak_auth](../README.md#keycloak_auth)
920
+
921
+ ### HTTP request headers
922
+
923
+ - **Content-Type**: application/json
924
+ - **Accept**: */*
925
+
926
+
927
+ ### HTTP response details
928
+ | Status code | Description | Response headers |
929
+ |-------------|-------------|------------------|
930
+ |**200** | OK | - |
931
+
932
+ [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
933
+
934
+ # **setSharingPolicyOverride**
935
+ > OverrideView setSharingPolicyOverride(overrideRequest)
936
+
937
+ A user\'s rule wins over their teams\'; several teams combine by union of their conditions; ALLOW on a team exempts its members from the global mode. Audited SHARING_POLICY_CHANGED. 404 outside the caller\'s organisation.
938
+
939
+ ### Example
940
+
941
+ ```typescript
942
+ import {
943
+ SharingPolicyApi,
944
+ Configuration,
945
+ OverrideRequest
946
+ } from '@openfilz-sdk/typescript-ee';
947
+
948
+ const configuration = new Configuration();
949
+ const apiInstance = new SharingPolicyApi(configuration);
950
+
951
+ let subjectId: string; // (default to undefined)
952
+ let overrideRequest: OverrideRequest; //
953
+
954
+ const { status, data } = await apiInstance.setSharingPolicyOverride(
955
+ subjectId,
956
+ overrideRequest
957
+ );
958
+ ```
959
+
960
+ ### Parameters
961
+
962
+ |Name | Type | Description | Notes|
963
+ |------------- | ------------- | ------------- | -------------|
964
+ | **overrideRequest** | **OverrideRequest**| | |
965
+ | **subjectId** | [**string**] | | defaults to undefined|
966
+
967
+
968
+ ### Return type
969
+
970
+ **OverrideView**
971
+
972
+ ### Authorization
973
+
974
+ [keycloak_auth](../README.md#keycloak_auth)
975
+
976
+ ### HTTP request headers
977
+
978
+ - **Content-Type**: application/json
979
+ - **Accept**: */*
980
+
981
+
982
+ ### HTTP response details
983
+ | Status code | Description | Response headers |
984
+ |-------------|-------------|------------------|
985
+ |**200** | OK | - |
986
+
987
+ [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
988
+