Skip to main content

​
Endpoint

POST https://api.ugc.inc/accounts/troubleshoot

​
Overview

Run diagnostics on your active accounts to identify health issues. Returns a healthy boolean and a fail_reason enum for each account that has a problem. Only accounts with status setup, warming, or warmed are included. This endpoint checks proxy connectivity and task success rates to determine account health.

​
Fail Reasons

ValueDescription
proxy_issueThe account’s proxy is either missing or failing connectivity checks. This means the account’s device cannot route traffic properly, which will cause warmup tasks and posts to fail.

​
Request Body

​
accountIds
string[]
Optional array of account IDs to check. If omitted, all active accounts are checked.

​
Response

​
data
TroubleshootAccount[]
Array of account health results
curl -X POST https://api.ugc.inc/accounts/troubleshoot \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

{
  "ok": true,
  "code": 200,
  "message": "Success",
  "data": [
    {
      "id": "acc_123456",
      "username": "fitness_guru",
      "type": "tiktok",
      "status": "warmed",
      "tag": "premium",
      "healthy": true,
      "fail_reason": null,
      "failed_tasks": 2,
      "total_tasks": 50
    },
    {
      "id": "acc_789012",
      "username": "cooking_tips",
      "type": "tiktok",
      "status": "warming",
      "tag": null,
      "healthy": false,
      "fail_reason": "proxy_issue",
      "failed_tasks": 15,
      "total_tasks": 20
    }
  ]
}