Skip to main content

​
Endpoint

POST https://api.ugc.inc/billing/request-replacement

​
Overview

Request a replacement for an account. The first replacement for any account is auto-approved — the old account is reclaimed and a new uninitialized account is created immediately. Subsequent replacement requests require manual admin review.

​
Request Body

​
account_id
string
required
ID of the account to replace
​
reason
string
Reason for requesting a replacement

​
Response

​
data
object
curl -X POST https://api.ugc.inc/billing/request-replacement \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"account_id": "acc_123", "reason": "Account was banned"}'

{
  "ok": true,
  "code": 200,
  "message": "Success",
  "data": {
    "message": "Replacement auto-approved. New account created.",
    "request": {
      "id": "req_123",
      "org_id": "org_123",
      "account_id": "acc_123",
      "type": "replacement",
      "status": "approved",
      "reason": "Account was banned",
      "created_at": "2025-01-15T10:00:00.000Z",
      "resolved_at": "2025-01-15T10:00:00.000Z"
    },
    "new_account_id": "acc_456"
  }
}