Skip to main content

​
Endpoint

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

​
Overview

Request a replacement for an account. All replacement requests require manual admin review. When the request is submitted, the account’s status is updated to needs_replacement. Once approved, the old account is reclaimed and a new uninitialized account is created in its place.

​
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"}'

import { UGCClient } from 'ugcinc';

const client = new UGCClient({ apiKey: 'YOUR_API_KEY' });
const response = await client.billing.requestReplacement({
  account_id: 'acc_123',
  reason: 'Account was banned'
});

if (response.ok) {
  console.log(response.data.message);
}

{
  "ok": true,
  "code": 200,
  "message": "Success",
  "data": {
    "message": "Replacement request submitted for review",
    "request": {
      "id": "req_124",
      "org_id": "org_123",
      "account_id": "acc_456",
      "type": "replacement",
      "status": "pending",
      "reason": "Account was banned",
      "created_at": "2026-04-18T10:00:00.000Z",
      "resolved_at": null
    }
  }
}