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

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

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>'

Responses

🟢200OK

application/json

Body

Example

{
    "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"
}

🟠401Unauthorized

🟠403Forbidden

Modified at 2025-12-03 07:59:44

Get wallet balance

Assign label

Remove label

Business Rules#

Request

Request Code Samples

Responses

Business Rules