ugcinc 2.1.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/posts.d.ts

@@ -1,5 +1,5 @@
 import { BaseClient } from './base';
-import type { Post, GetPostsParams, CreateSlideshowParams, GetPostStatusParams, CreateVideoParams, DeletePostsParams, RetryPostsParams, ApiResponse } from './types';
+import type { Post, GetPostsParams, CreateSlideshowParams, GetPostStatusParams, CreateVideoParams, DeletePostsParams, DeletePostsResponse, RetryPostsParams, ApiResponse } from './types';
 /**
  * Client for managing posts
  */
@@ -26,12 +26,15 @@ export declare class PostsClient extends BaseClient {
     createVideo(params: CreateVideoParams): Promise<ApiResponse<Post>>;
     /**
      * Delete posts
-     * Note: Posts with status "complete" (already posted) cannot be deleted
+     *
+     * Handles both unpublished and published posts:
+     * - Unpublished posts (scheduled, pending, failed, retrying) are deleted immediately
+     * - Published posts (complete) trigger a deletion flow that removes the post from the social platform
+     *
+     * For published posts being deleted, the status changes to "deleting" and then "deleted" once complete.
+     * Monitor deletion progress using getStatus().
      */
-    deletePosts(params: DeletePostsParams): Promise<ApiResponse<{
-        deleted: number;
-        ids: string[];
-    }>>;
+    deletePosts(params: DeletePostsParams): Promise<ApiResponse<DeletePostsResponse>>;
     /**
      * Retry failed posts
      * Note: Only posts with status "failed" can be retried

package/dist/posts.js

@@ -32,7 +32,13 @@ class PostsClient extends base_1.BaseClient {
     }
     /**
      * Delete posts
-     * Note: Posts with status "complete" (already posted) cannot be deleted
+     *
+     * Handles both unpublished and published posts:
+     * - Unpublished posts (scheduled, pending, failed, retrying) are deleted immediately
+     * - Published posts (complete) trigger a deletion flow that removes the post from the social platform
+     *
+     * For published posts being deleted, the status changes to "deleting" and then "deleted" once complete.
+     * Monitor deletion progress using getStatus().
      */
     async deletePosts(params) {
         return this.post('/post/delete', params);

package/dist/types.d.ts

@@ -30,6 +30,9 @@ export interface Account {
     warmup_enabled: boolean | null;
     keywords: string | null;
     profiles: string | null;
+    niches: string | null;
+    age_range: string | null;
+    sex: string | null;
     status: 'pending' | 'initialized' | 'setup' | 'error';
 }
 export interface AccountStat {
@@ -129,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;
@@ -174,6 +189,16 @@ export interface CreateVideoParams {
 export interface DeletePostsParams {
     postIds: string[];
 }
+export interface DeletePostsResponse {
+    deleted: number;
+    deleting: number;
+    deletedIds: string[];
+    deletingIds: string[];
+    errors?: Array<{
+        postId: string;
+        error: string;
+    }>;
+}
 export interface RetryPostsParams {
     postIds: string[];
 }

package/package.json

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