Skip to main content

​
Endpoint

POST https://api.ugc.inc/accounts/reset-warmup

​
Overview

Reset warmup activity for an account. This endpoint has two modes:
  • Reset mode (default): Resets the run count for all warmup tasks, causing them to re-execute
  • Delete mode: Completely removes all warmup tasks from the account
This is useful when you want to restart the warmup process or clear all warmup activity.

​
Request Body

​
accountId
string
required
The ID of the account to reset warmup for
​
delete_activity
boolean
default:false
If true, deletes all warmup tasks completely. If false (default), resets task run counts so they will re-execute

​
Response

​
message
string
Success message describing the action taken
​
tasks_affected
number
Number of warmup tasks that were reset or deleted
​
action
'reset' | 'deleted'
The action that was performed: 'reset' if tasks were reset to re-run, 'deleted' if tasks were removed

​
Reset vs Delete

​
Reset Mode (delete_activity: false)

  • Tasks remain in the database but are marked to re-run
  • Task history is preserved
  • Warmup will resume from the beginning
  • Use when you want to restart warmup while keeping task records

​
Delete Mode (delete_activity: true)

  • All warmup tasks are permanently removed
  • Task history is lost
  • Account can have fresh warmup tasks scheduled
  • Use when you want to completely clear warmup activity
curl -X POST https://api.ugc.inc/accounts/reset-warmup \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "accountId": "acc_123456",
    "delete_activity": false
  }'

{
  "ok": true,
  "code": 200,
  "message": "Success",
  "data": {
    "message": "Successfully reset warmup for account (tasks will re-run)",
    "tasks_affected": 12,
    "action": "reset"
  }
}