POST /v1/users/:userId/characters/:characterId/cancel

Use this endpoint to cancel a pending character submission and return the character to draft status. This is useful when you have already submitted a character for review but need to make further changes before staff complete their review. Once cancelled, the character’s idStatus returns to draft and you can edit it again using the Update Character endpoint.

You cannot cancel a character that has already been approved. Attempting to do so will return a 403 error. Approved characters are considered finalised and their status cannot be reversed through this endpoint.

If the character is already in draft status when you call this endpoint, the server will return 304 Not Modified with the unchanged character object — no state transition occurs.

Endpoint

POST https://api.cacolombia.com/v1/users/:userId/characters/:characterId/cancel

Path Parameters

string

required

The Snowflake ID of the user who owns the character. Must match the authenticated user’s ID.

string

required

The Snowflake ID of the character whose submission you want to cancel.

Query Parameters

string

Pass true to include the character’s signatureData field in the response. Omit or pass any other value to exclude it.

Request Body

This endpoint does not require a request body.

Response

Returns 201 Created with the updated character object reflecting the restored draft status. If the character was already in draft status, returns 304 Not Modified with the unchanged character object.

string

The character’s unique Snowflake ID.

string

The Snowflake ID of the user who owns this character.

string

The character’s first name(s).

string

The character’s last name(s).

number

The character’s age in years.

number

The character’s height in centimetres.

string

The character’s gender. Either Masculino or Femenino.

string

The character’s blood type.

object

An object describing the character’s nationality with nombre, abrev, and lugar fields.

string

The character’s date of birth in DD/MM/YYYY format.

string

The character’s restored status. Will be draft after a successful cancellation.

string | null

Hash identifier for the character’s avatar image.

string | null

Hash identifier for the character’s ID card image.

string | null

Hash identifier for the character’s full-body image.

string | null

Hash identifier for the character’s 3D GLB model.

object | null

Camera metadata for the 3D avatar, or null if not set.

object | null

Bounding box metadata for the 3D avatar, or null if not set.

object | null

The character’s in-game wallet, or null if none exists.

string

The character’s signature data. Only present when signature=true is passed.

string

ISO 8601 timestamp of when the character was created.

string

ISO 8601 timestamp of when the character was last updated.

Example Request

curl -X POST "https://api.cacolombia.com/v1/users/112233445566778899/characters/998877665544332211/cancel" \
  -H "Authorization: Bearer <your_token>"

Example Response

{
  "characterId": "998877665544332211",
  "userId": "112233445566778899",
  "firstNames": "Carlos Alberto",
  "lastNames": "Reyes Gómez",
  "age": 28,
  "height": 175,
  "gender": "Masculino",
  "bloodType": "O+",
  "nationality": {
    "nombre": "Colombiano",
    "abrev": "COL",
    "lugar": "Colombia"
  },
  "dob": "15/04/1996",
  "avatarHash": "abc123def456",
  "idCardHash": null,
  "fullBodyHash": "fgh789ijk012",
  "avatar3dHash": null,
  "avatar3dCamera": null,
  "avatar3dAABB": null,
  "idStatus": "draft",
  "wallet": null,
  "createdAt": "2024-01-10T14:30:00.000Z",
  "updatedAt": "2024-06-15T13:00:00.000Z"
}

Error Responses

Status	Error	Description
`401`	`Unauthorized`	No valid authentication token was provided.
`403`	`Forbidden`	The authenticated user does not match the `userId` in the path.
`403`	`Unauthorized`	The character has already been approved and cannot be cancelled.
`304`	(no error)	The character was already in `draft` status — no change was made. The character object is returned as-is.
`404`	`Unknown User`	No user was found with the given `userId`.
`404`	`Unknown Character`	No character was found with the given `characterId` belonging to this user.
`500`	`Missing character data`	An internal error occurred while attempting to update the character’s status.

Overview

Auth & OAuth

Users

Characters

Economy

Banking

Staff

Utilities

POST /v1/users/:userId/characters/:characterId/cancel

Endpoint

Path Parameters

Query Parameters

Request Body

Response

Example Request

Example Response

Error Responses

​Endpoint

​Path Parameters

​Query Parameters

​Request Body

​Response

​Example Request

​Example Response

​Error Responses

Endpoint

Path Parameters

Query Parameters

Request Body

Response

Example Request

Example Response

Error Responses