Remove label from wallet

DELETE

https://api.staging.vrtx.sa/cl/v1/wallets/{wallet_id}/labels

Last modified:2026-04-16 11:33:59

Unassign the current label from a specific wallet within the closed-loop system.
This operation removes the logical association between a wallet and its label, without deleting the wallet or the label itself.

Use this endpoint when reclassifying wallets, archiving old categories, or cleaning up label associations.

Business Rules

The wallet must exist within the closed-loop system.

Each wallet can only have one label, so no label_id is required.

Removing a label does not delete the wallet or the label definition.

If the wallet has no label, this operation succeeds without modification.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Path Params

Responses

🟢200OK

application/json

Body

🟠401Unauthorized

🟠403Forbidden

🟠404Not Found

Request Example

Shell

JavaScript

Java

Swift

curl --location --request DELETE 'https://api.staging.vrtx.sa/cl/v1/wallets/d8a7f71f-cabd-4720-b7cc-b6745a10cbe2/labels' \
--header 'Authorization: Bearer <token>'

Response Example

200 - WalletWithoutLabel

{
    "id": "d8a7f71f-cabd-4720-b7cc-b6745a10cbe2",
    "business_id": "2bb58ca6-1b9a-47b4-ab4d-b2996f0498f3",
    "name": "محفظة رئيسية",
    "external_reference": "WALLET-RIYADH-00122",
    "can_overdraft": false,
    "status": "ACTIVE",
    "account_number": "054200007018",
    "currency": "SAR",
    "balance": "0.00",
    "created_at": "2025-10-25T14:10:15.151Z",
    "updated_at": "2025-10-25T14:26:22.951Z"
}

Modified at 2026-04-16 11:33:59

Get wallet balance

Remove specific label

Remove label from wallet

Business Rules#

Request

Responses

Business Rules