feat: add Shield Lists APIs (box/box-openapi#528)

.codegen.json

@@ -1 +1 @@
-{ "engineHash": "20cb559", "specHash": "a54170e", "version": "1.15.1" }
+{ "engineHash": "20cb559", "specHash": "630fc85", "version": "1.15.1" }

docs/README.md

@@ -58,6 +58,7 @@ the SDK are available by topic:
 - [Shield information barrier segment restrictions](shieldInformationBarrierSegmentRestrictions.md)
 - [Shield information barrier segments](shieldInformationBarrierSegments.md)
 - [Shield information barriers](shieldInformationBarriers.md)
+- [Shield lists](shieldLists.md)
 - [Sign requests](signRequests.md)
 - [Sign templates](signTemplates.md)
 - [Skills](skills.md)

docs/shieldLists.md

@@ -0,0 +1,129 @@
+# ShieldListsManager
+
+- [Get all shield lists in enterprise](#get-all-shield-lists-in-enterprise)
+- [Create shield list](#create-shield-list)
+- [Get single shield list by shield list id](#get-single-shield-list-by-shield-list-id)
+- [Delete single shield list by shield list id](#delete-single-shield-list-by-shield-list-id)
+- [Update shield list](#update-shield-list)
+
+## Get all shield lists in enterprise
+
+Retrieves all shield lists in the enterprise.
+
+This operation is performed by calling function `getShieldListsV2025R0`.
+
+See the endpoint docs at
+[API Reference](https://developer.box.com/reference/v2025.0/get-shield-lists/).
+
+_Currently we don't have an example for calling `getShieldListsV2025R0` in integration tests_
+
+### Arguments
+
+- headersInput `GetShieldListsV2025R0HeadersInput`
+  - Headers of getShieldListsV2025R0 method
+- cancellationToken `undefined | CancellationToken`
+  - Token used for request cancellation.
+
+### Returns
+
+This function returns a value of type `ShieldListsV2025R0`.
+
+Returns the list of shield list objects.
+
+## Create shield list
+
+Creates a shield list.
+
+This operation is performed by calling function `createShieldListV2025R0`.
+
+See the endpoint docs at
+[API Reference](https://developer.box.com/reference/v2025.0/post-shield-lists/).
+
+_Currently we don't have an example for calling `createShieldListV2025R0` in integration tests_
+
+### Arguments
+
+- requestBody `ShieldListsCreateV2025R0`
+  - Request body of createShieldListV2025R0 method
+- optionalsInput `CreateShieldListV2025R0OptionalsInput`
+  -
+
+### Returns
+
+This function returns a value of type `ShieldListV2025R0`.
+
+Returns the shield list object.
+
+## Get single shield list by shield list id
+
+Retrieves a single shield list by its ID.
+
+This operation is performed by calling function `getShieldListByIdV2025R0`.
+
+See the endpoint docs at
+[API Reference](https://developer.box.com/reference/v2025.0/get-shield-lists-id/).
+
+_Currently we don't have an example for calling `getShieldListByIdV2025R0` in integration tests_
+
+### Arguments
+
+- shieldListId `string`
+  - The unique identifier that represents a shield list. The ID for any Shield List can be determined by the response from the endpoint fetching all shield lists for the enterprise. Example: "90fb0e17-c332-40ed-b4f9-fa8908fbbb24 "
+- optionalsInput `GetShieldListByIdV2025R0OptionalsInput`
+  -
+
+### Returns
+
+This function returns a value of type `ShieldListV2025R0`.
+
+Returns the shield list object.
+
+## Delete single shield list by shield list id
+
+Delete a single shield list by its ID.
+
+This operation is performed by calling function `deleteShieldListByIdV2025R0`.
+
+See the endpoint docs at
+[API Reference](https://developer.box.com/reference/v2025.0/delete-shield-lists-id/).
+
+_Currently we don't have an example for calling `deleteShieldListByIdV2025R0` in integration tests_
+
+### Arguments
+
+- shieldListId `string`
+  - The unique identifier that represents a shield list. The ID for any Shield List can be determined by the response from the endpoint fetching all shield lists for the enterprise. Example: "90fb0e17-c332-40ed-b4f9-fa8908fbbb24 "
+- optionalsInput `DeleteShieldListByIdV2025R0OptionalsInput`
+  -
+
+### Returns
+
+This function returns a value of type `undefined`.
+
+Shield List correctly removed. No content in response.
+
+## Update shield list
+
+Updates a shield list.
+
+This operation is performed by calling function `updateShieldListByIdV2025R0`.
+
+See the endpoint docs at
+[API Reference](https://developer.box.com/reference/v2025.0/put-shield-lists-id/).
+
+_Currently we don't have an example for calling `updateShieldListByIdV2025R0` in integration tests_
+
+### Arguments
+
+- shieldListId `string`
+  - The unique identifier that represents a shield list. The ID for any Shield List can be determined by the response from the endpoint fetching all shield lists for the enterprise. Example: "90fb0e17-c332-40ed-b4f9-fa8908fbbb24 "
+- requestBody `ShieldListsUpdateV2025R0`
+  - Request body of updateShieldListByIdV2025R0 method
+- optionalsInput `UpdateShieldListByIdV2025R0OptionalsInput`
+  -
+
+### Returns
+
+This function returns a value of type `ShieldListV2025R0`.
+
+Returns the shield list object.

src/client.generated.ts

@@ -76,6 +76,7 @@ import { AiManager } from './managers/ai.generated.js';
 import { AiStudioManager } from './managers/aiStudio.generated.js';
 import { DocgenTemplateManager } from './managers/docgenTemplate.generated.js';
 import { DocgenManager } from './managers/docgen.generated.js';
+import { ShieldListsManager } from './managers/shieldLists.generated.js';
 import { Authentication } from './networking/auth.generated.js';
 import { NetworkSession } from './networking/network.generated.js';
 import { BoxSdkError } from './box/errors.js';
@@ -171,6 +172,7 @@ export class BoxClient {
   readonly aiStudio: AiStudioManager;
   readonly docgenTemplate: DocgenTemplateManager;
   readonly docgen: DocgenManager;
+  readonly shieldLists: ShieldListsManager;
   constructor(
     fields: Omit<
       BoxClient,
@@ -248,6 +250,7 @@ export class BoxClient {
       | 'aiStudio'
       | 'docgenTemplate'
       | 'docgen'
+      | 'shieldLists'
       | 'networkSession'
       | 'makeRequest'
       | 'withAsUserHeader'
@@ -568,6 +571,10 @@ export class BoxClient {
       auth: this.auth,
       networkSession: this.networkSession,
     });
+    this.shieldLists = new ShieldListsManager({
+      auth: this.auth,
+      networkSession: this.networkSession,
+    });
   }
   /**
    * Make a custom http request using the client authentication and network session.