DELETE /v1/banks/:bankId — Permanently Delete Bank

Use this endpoint to permanently remove an in-game bank from the platform. This operation is irreversible — once a bank is deleted, the bank data cannot be recovered.

Deleting a bank is permanent. Ensure you have confirmed this action with the relevant parties before proceeding. This endpoint requires the ADMINISTRATOR permission.

Endpoint

DELETE https://api.cacolombia.com/v1/banks/:bankId

Path Parameters

string

required

The Snowflake ID of the bank you want to delete.

Response

A successful deletion returns HTTP 204 No Content along with the bank object as it existed immediately before deletion.

string

The Snowflake ID of the deleted bank.

string

The characterId of the character who owned the bank.

string

The display name of the bank at the time of deletion.

string | null

The icon hash at the time of deletion, or null if none was set.

number

The bank’s capital balance at the time of deletion.

string

ISO 8601 timestamp of when the bank was originally created.

string

ISO 8601 timestamp of the last modification before deletion.

Example Request

curl -X DELETE "https://api.cacolombia.com/v1/banks/112233445566778800" \
  -H "Authorization: Bearer <your_token>"

Example Response

{
  "bankId": "112233445566778800",
  "ownerId": "998877665544332211",
  "name": "Banco Nacional",
  "iconHash": null,
  "capital": 1000000,
  "createdAt": "2024-06-01T08:00:00.000Z",
  "updatedAt": "2024-06-05T12:30:00.000Z"
}

Error Responses

Status	Description
`401`	You are not authenticated. Provide a valid authorization token with your request.
`403`	Your account does not hold the `ADMINISTRATOR` permission.
`404`	No bank was found for the given `bankId`.

Rate limiting applies to this endpoint. You can call it at most 5 times per minute per account.

Overview

Auth & OAuth

Users

Characters

Economy

Banking

Staff

Utilities

DELETE /v1/banks/:bankId — Permanently Delete Bank

Endpoint

Path Parameters

Response

Example Request

Example Response

Error Responses

​Endpoint

​Path Parameters

​Response

​Example Request

​Example Response

​Error Responses

Endpoint

Path Parameters

Response

Example Request

Example Response

Error Responses