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 '{}'

import requests

response = requests.post(
    'https://api.ugc.inc/accounts/troubleshoot',
    headers={
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json'
    },
    json={}
)

data = response.json()

if data['ok']:
    unhealthy = [a for a in data['data'] if not a['healthy']]
    print(f'{len(unhealthy)} accounts have issues')
    for account in unhealthy:
        print(f"  {account['username']}: {account['fail_reason']}")

const response = await fetch('https://api.ugc.inc/accounts/troubleshoot', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({})
});

const data = await response.json();

if (data.ok) {
  const unhealthy = data.data.filter(a => !a.healthy);
  console.log(`${unhealthy.length} accounts have issues`);
}

import { UGCClient } from 'ugcinc';

const client = new UGCClient({
  apiKey: 'YOUR_API_KEY'
});

// Check all active accounts
const response = await client.accounts.troubleshoot();

// Check specific accounts
const response2 = await client.accounts.troubleshoot({
  accountIds: ['acc_123', 'acc_456']
});

if (response.ok) {
  const unhealthy = response.data.filter(a => !a.healthy);
  console.log(`${unhealthy.length} accounts have issues`);
}

{
  "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
    }
  ]
}