Skip to main content
Every playable character in CA Colombia moves through a defined set of states before becoming active in the game. You start by creating a draft, fill in the required details, then submit it for staff review. Staff either approve or reject the submission — an approved character becomes active and receives a wallet automatically. This guide covers every step and every API call involved in that journey.

​
Status Overview

​
Creating a Character

Send a POST request to /v1/users/{userId}/characters to create a new character in draft status. You must be authenticated as the user specified in the path — you cannot create characters on behalf of another user. Endpoint: POST /v1/users/{userId}/characters Request body
A successful request returns 201 Created with the full character object, including the newly assigned characterId and an idStatus of "draft". Error responses
Each user account has a maximum character limit. If you hit a 409, you must delete an existing character before creating a new one.

​
Editing the Draft

While a character is in draft (or rejected) status, you can update any of its fields with a PATCH request. All fields are optional — include only the ones you want to change. Endpoint: PATCH /v1/users/{userId}/characters/{characterId}
Once a character is submitted, edits are locked until the submission is cancelled.

​
Submitting for Review

When you are ready for staff to review the character, submit it with a POST to the submit endpoint. The character’s status changes from draft to submitted. Endpoint: POST /v1/users/{userId}/characters/{characterId}/submit No request body is required. A successful submission returns 201 with the updated character object. You can also append ?signature=true to include the character’s signature data in the response. Error responses
Once submitted, you can no longer edit the character. If you need to make changes after submitting, cancel the submission first to return it to draft status.

​
Cancelling a Submission

If a character is in submitted status and you need to make further changes, cancel the submission to move it back to draft. Endpoint: POST /v1/users/{userId}/characters/{characterId}/cancel No request body is required. On success, the server returns 201 with the character in draft status. Behaviour by status

​
After Approval

When staff approve a character, the character’s idStatus transitions to "approved". The character is now active in the game. A wallet is automatically created and linked to the character the first time the character’s data is fetched after approval. If wallet is null in the response, make a GET request to the character endpoint to trigger wallet creation. Approved characters are active in the game and cannot be re-submitted or edited through the lifecycle endpoints. To query the character’s linked bank accounts, use GET /v1/users/{userId}/characters/{characterId}/bankAccounts.
Subscribe to the characters:update WebSocket topic to receive a real-time notification the moment a character’s status changes. See the WebSocket guide for details.