Skip to main content

​
Endpoint

POST https://api.ugc.inc/accounts/delete-posts

​
Overview

Delete all posts from one or more accounts. This endpoint creates a clear_posts task for each account 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
The deletion process runs asynchronously. Posts are marked as “deleting” during the process and “deleted” once confirmed removed from the platform.

​
Request Body

​
accountIds
string[]
required
Array of account IDs to delete posts from

​
Response

​
data
object
Response object containing deletion task results

​
Deletion Process

  1. A clear_posts task is created for each account
  2. The task finds the first complete post with a social_id
  3. A deletion flow is triggered on the platform
  4. Once the platform confirms deletion, the system verifies using the scrape API
  5. If verified, the post is marked as “deleted” and the next post is found
  6. Steps 3-5 repeat until no more posts exist
  7. The task is marked as complete
  • Accounts must have a GeeLark phone ID configured
  • Only posts with status “complete” and a social_id are deleted
  • The deletion process is automatic and continues until all posts are removed
  • You can monitor progress using the /accounts/status endpoint
curl -X POST https://api.ugc.inc/accounts/delete-posts \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "accountIds": ["acc_123456", "acc_789012"]
  }'

{
  "ok": true,
  "code": 200,
  "message": "Scheduled post deletion for 2 account(s)",
  "data": {
    "message": "Scheduled post deletion for 2 account(s)",
    "successful": 2,
    "failed": 0
  }
}