ugcinc 2.2.0 → 2.3.0

package/README.md

@@ -48,6 +48,7 @@ For complete API documentation, including all endpoints, parameters, and example
 - Get account status (tasks)
 - Update account info (tags, groups)
 - Update social profile (avatar, nickname, bio)
+- Delete all posts from accounts (automated batch deletion)
 
 ### Posts
 - Create video posts (with specific account or auto-select)
@@ -102,6 +103,42 @@ if (response.ok) {
 }
 ```
 
+**Delete all posts from accounts:**
+```typescript
+// Delete all posts from one or more accounts
+// This creates a clear_posts task that automatically:
+// - Finds all complete posts with a social_id
+// - Deletes them one by one from the platform
+// - Verifies each deletion using the platform API
+// - Continues until all posts are deleted
+const response = await client.accounts.deleteAllPosts({
+  accountIds: ['account-uuid-1', 'account-uuid-2']
+});
+
+if (response.ok) {
+  console.log(`Deletion scheduled for ${response.data.successful} account(s)`);
+  
+  if (response.data.failed > 0) {
+    console.log(`Failed for ${response.data.failed} account(s)`);
+    response.data.errors?.forEach(err => {
+      console.log(`  - ${err.accountId}: ${err.error}`);
+    });
+  }
+}
+
+// Monitor deletion progress using account status
+const statusResponse = await client.accounts.getStatus({
+  accountIds: ['account-uuid-1']
+});
+
+if (statusResponse.ok) {
+  const clearPostsTask = statusResponse.data.find(task => task.type === 'clear_posts');
+  if (clearPostsTask) {
+    console.log(`Deletion task status: ${clearPostsTask.status}`);
+  }
+}
+```
+
 **Get your organization's API keys:**
 ```typescript
 const response = await client.org.getApiKeys(); // POST /org/api-key

package/dist/accounts.d.ts

@@ -1,5 +1,5 @@
 import { BaseClient } from './base';
-import type { Account, AccountTask, GetAccountsParams, GetAccountStatusParams, UpdateAccountInfoParams, UpdateAccountSocialParams, ApiResponse } from './types';
+import type { Account, AccountTask, GetAccountsParams, GetAccountStatusParams, UpdateAccountInfoParams, UpdateAccountSocialParams, DeleteAccountPostsParams, DeleteAccountPostsResponse, ApiResponse } from './types';
 /**
  * Client for managing accounts
  */
@@ -26,4 +26,10 @@ export declare class AccountsClient extends BaseClient {
     updateSocial(params: UpdateAccountSocialParams): Promise<ApiResponse<{
         message: string;
     }>>;
+    /**
+     * Delete all posts from one or more accounts
+     * Creates a clear_posts task that automatically deletes all posts from the account(s)
+     * Posts are deleted one by one and verified using the platform API
+     */
+    deleteAllPosts(params: DeleteAccountPostsParams): Promise<ApiResponse<DeleteAccountPostsResponse>>;
 }

package/dist/accounts.js

@@ -31,5 +31,13 @@ class AccountsClient extends base_1.BaseClient {
     async updateSocial(params) {
         return this.post('/accounts/update-social', params);
     }
+    /**
+     * Delete all posts from one or more accounts
+     * Creates a clear_posts task that automatically deletes all posts from the account(s)
+     * Posts are deleted one by one and verified using the platform API
+     */
+    async deleteAllPosts(params) {
+        return this.post('/accounts/delete-posts', params);
+    }
 }
 exports.AccountsClient = AccountsClient;

package/dist/types.d.ts

@@ -132,6 +132,18 @@ export interface UpdateAccountSocialParams {
     nickName?: string;
     bio?: string;
 }
+export interface DeleteAccountPostsParams {
+    accountIds: string[];
+}
+export interface DeleteAccountPostsResponse {
+    message: string;
+    successful: number;
+    failed: number;
+    errors?: Array<{
+        accountId: string;
+        error: string;
+    }>;
+}
 export interface GetTasksParams {
     accountIds?: string[];
     startDate?: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ugcinc",
-  "version": "2.2.0",
+  "version": "2.3.0",
   "description": "TypeScript/JavaScript client for the UGC Inc API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",