POST /v1/staff/characters/reject — Reject Characters

Use this endpoint to reject one or more characters that are in the pending_approval review queue. Rejecting a character sets its idStatus back to draft, allowing the applicant to revise and resubmit it. You can reject multiple characters in a single request by passing an array of characterId values.

Rejected characters are not deleted — their status is simply set back to draft. The applicant can update their character and submit it for review again.

This endpoint requires the MODERATOR_CHIEF, ADMINISTRATOR, or DEVELOPER permission. Regular user accounts cannot reject characters.

Endpoint

POST https://api.cacolombia.com/v1/staff/characters/reject

Request Body

string[]

required

An array of character Snowflake IDs to reject. All characters in the array are processed in a single batch operation and have their idStatus set back to draft.

Response

A successful 200 response returns the updated character objects after rejection:

array

An array of character objects reflecting their updated draft status. The array includes one entry for each character that was processed. Each object contains the full character data as returned by getApiCharacterData().

Example Request

curl -X POST "https://api.cacolombia.com/v1/staff/characters/reject" \
  -H "Authorization: Bearer <your_token>" \
  -H "Content-Type: application/json" \
  -d '{"characterIds": ["998877665544332211", "111222333444555666"]}'

Example Response

{
  "characters": [
    {
      "characterId": "998877665544332211",
      "userId": "112233445566778899",
      "firstNames": "Carlos",
      "lastNames": "Rodríguez",
      "age": 30,
      "height": 178,
      "gender": "Masculino",
      "bloodType": "O+",
      "nationality": {
        "nombre": "Colombiano",
        "abrev": "COL",
        "lugar": "Colombia"
      },
      "dob": "01/03/1994",
      "avatarHash": "abc123def456",
      "idCardHash": null,
      "fullBodyHash": "def456ghi789",
      "avatar3dHash": null,
      "avatar3dCamera": null,
      "avatar3dAABB": null,
      "idStatus": "draft",
      "wallet": null,
      "createdAt": "2024-06-07T14:00:00.000Z",
      "updatedAt": "2024-06-08T10:15:00.000Z"
    }
  ]
}

Error Responses

Status	Description
`400`	The request body is missing `characterIds`, the field is not an array, or the array contains non-string values.
`401`	You are not authenticated. Provide a valid authorization token with your request.
`403`	Your account does not hold any of the required staff permissions.
`500`	The batch rejection could not be completed. This is an internal server error — try again or contact support if the issue persists.

Rate limiting applies to this endpoint. You can call it at most 10 times per minute. Batch your characterIds to reject multiple characters in a single request rather than making separate calls.

Overview

Auth & OAuth

Users

Characters

Economy

Banking

Staff

Utilities

POST /v1/staff/characters/reject — Reject Characters

Endpoint

Request Body

Response

Example Request

Example Response

Error Responses

​Endpoint

​Request Body

​Response

​Example Request

​Example Response

​Error Responses

Endpoint

Request Body

Response

Example Request

Example Response

Error Responses