Update client status

PATCH

/customers/v1/clients/{id}

Update a client — for example to set its status (ACTIVE or INACTIVE). Kobble-performed operation. This endpoint requires the administrator/write scope, which is reserved for Kobble-internal credentials and is not granted to client API credentials — requesting it at the token endpoint will be rejected.

Partial update — all fields optional. Business rule: setting fees_paid_by: CLIENT requires client_wallet_id referencing an ACTIVE KOBBLE_AUD_1 wallet; violations fail with 400.

Request

Path Params

Header Params

Body Params application/json

Example

{
    "status": "ACTIVE"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request PATCH '/customers/v1/clients/' \
--header 'x-client-id;' \
--header 'Content-Type: application/json' \
--data '{
    "status": "ACTIVE"
}'

Responses

🟢200OK

application/json

Bodyapplication/json

Example

{
    "id": "c700c274-10df-4e36-941a-4e873ef7bedf",
    "name": "Douglas Wilderman",
    "email": "Verda89@yahoo.com",
    "status": "ACTIVE",
    "created_at": "2025-01-14T16:32:12.921Z",
    "updated_at": "2025-01-14T16:32:12.926Z",
    "metadata": {},
    "external_id": null,
    "fees_paid_by": null,
    "client_wallet_id": null
}

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

Modified at 2026-08-05 04:06:11

Create a new client

Endusers API