Merge pull request #121 from Space-DF/feat/implement-bulk-update-entity

feat: implementbulk update entity

Author: huyphan02

api.doc.md

@@ -3714,7 +3714,7 @@ await client.trip.delete('trip-uuid-456');
 
 ## Overview
 
-The `Telemetry` class provides methods for retrieving telemetry entities, alerts, events, automations, actions, notifications, and geofences. This class allows you to search and filter telemetry entities by display type and search terms, retrieve alerts, query events by device, list telemetry actions, manage notification subscriptions, manage automations (list, create, retrieve, update, delete), and manage geofences (list, create, retrieve, update, delete, test).
+The `Telemetry` class provides methods for retrieving telemetry entities, alerts, events, automations, actions, notifications, and geofences. This class allows you to search and filter telemetry entities by display type and search terms, bulk-update entity visibility (visible and hidden IDs), retrieve alerts, query events by device, list telemetry actions, manage notification subscriptions, manage automations (list, create, retrieve, update, delete), and manage geofences (list, create, retrieve, update, delete, test).
 
 ## Methods
 
@@ -3772,6 +3772,37 @@ console.log(entities.count);
 
 </details>
 
+<details>
+  <summary><strong>entities.bulkUpdate</strong></summary>
+
+Bulk-update telemetry entity visibility by sending arrays of entity IDs to mark as visible or hidden. This issues a `POST` to `/telemetry/v1/entities/bulk-update` with a JSON body.
+
+**Signature:**
+
+```typescript
+bulkUpdate(params: BulkUpdateEntitiesParams, options?: Core.RequestOptions): Core.APIPromise<void>
+```
+
+**Parameters:**
+
+-   `params` _(BulkUpdateEntitiesParams)_: JSON body parameters:
+    -   `visible_entity_ids` _(string[])_: Entity IDs to set as visible.
+    -   `hidden_entity_ids` _(string[])_: Entity IDs to set as hidden.
+-   `options` _(Core.RequestOptions)_: Additional request options.
+
+**Returns:** `Promise<void>`
+
+**Example:**
+
+```typescript
+await client.telemetry.entities.bulkUpdate({
+    visible_entity_ids: ['entity-id-1', 'entity-id-2'],
+    hidden_entity_ids: ['entity-id-3'],
+});
+```
+
+</details>
+
 <details>
   <summary><strong>alerts.list</strong></summary>
 

src/resources/telemetry/entities.ts

@@ -8,7 +8,14 @@ export class Entities extends APIResource {
         return this._client.get(`/telemetry/v1/entities`, {
             query,
             ...options,
-            headers: { ...options?.headers },
+        });
+    }
+
+    bulkUpdate(params: BulkUpdateEntitiesParams, options?: Core.RequestOptions): Core.APIPromise<void> {
+        const { ...body } = params;
+        return this._client.put(`/telemetry/v1/entities/bulk-update`, {
+            body,
+            ...options,
         });
     }
 }
@@ -49,3 +56,15 @@ export interface EntitiesListParams extends ListParamsResponse {
      */
     search?: string;
 }
+
+export interface BulkUpdateEntitiesParams {
+    /**
+     * Body param: Array of visible entity IDs to update.
+     */
+    visible_entity_ids: string[];
+
+    /**
+     * Body param: Array of hidden entity IDs to update.
+     */
+    hidden_entity_ids: string[];
+}