Remove label

DELETE

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

Last modified:2025-12-03 07:59:44

Unassign a 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 and label must both exist within the closed-loop system.

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

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

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

Path Params

Responses

🟢200OK

application/json

Body

🟠401Unauthorized

🟠403Forbidden

Request Example

Shell

JavaScript

Java

Swift

curl --location --request DELETE 'https://api.staging.vrtx.sa/cl/v1/wallets/d8a7f71f-cabd-4720-b7cc-b6745a10cbe2/labels/5a36c74a-e479-43cd-a420-fb72a591d3e6' \
--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 2025-12-03 07:59:44

Get wallet balance

Assign label

Remove label

Business Rules#

Request

Responses

Business Rules