Request Replacement

Request a replacement for an account

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

Show Response properties

message · string

Confirmation message

request · object | null

The billing request record

Show Request properties

id · string

Request ID

type · 'replacement'

Request type

status · 'pending'

Request status (always pending on creation)

cURL

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

Success Response

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