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

Use this endpoint to submit a character for staff review. The character must currently be in draft status. Once submitted, the character’s idStatus transitions to pending_approval and it is queued for review by the CA Colombia staff team. While a character is in pending_approval status, you cannot make further edits to it. If you need to make changes after submission, use the Cancel Submission endpoint to return it to draft status.

Before submitting, make sure the character has all required avatar assets uploaded. If the required data is missing, the server will return a 500 error indicating that the character cannot be validated for ID creation.

You can only submit characters belonging to your own account. The authenticated token must match the userId in the path.

Endpoint

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

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 to submit for review.

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 new pending_approval status.

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 updated status. Will be pending_approval after a successful call.

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/submit" \
  -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": "pending_approval",
  "wallet": null,
  "createdAt": "2024-01-10T14:30:00.000Z",
  "updatedAt": "2024-06-15T12: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.
`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.
`409`	`Duplicate Submission`	The character is not in `draft` status and has already been submitted or approved.
`500`	`Missing character data`	The character is missing required avatar components and cannot be submitted for ID creation.

Overview

Auth & OAuth

Users

Characters

Economy

Banking

Staff

Utilities

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

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