WalletD developers
Catalog

Delete an unused category

Deletes a category and answers 204. Needs authority over the client — membership of its organization, an API key bound to this client, or tenant staff holding clients:manage; anything else is refus...

DELETE/v1/clients/{clientId}/categories/{categoryId}

Deletes a category and answers 204. Needs authority over the client — membership of its organization, an API key bound to this client, or tenant staff holding clients:manage; anything else is refused not_client_member or insufficient_scope (403), and an unknown client client_not_found (404). A category that still holds products or subcategories is refused conflict (409) with the counts in the detail; an unknown category gives not_found (404).

Authorization

bearerAuth
AuthorizationBearer <token>

A tenant API key (sk_{env}_{id}_{secret}), a wallet user token, or an IdP access token. Which principal the credential resolves to decides the scopes it carries; see the authentication guide.

In: header

Path Parameters

clientId*string
Formatuuid
categoryId*string
Formatuuid

Response Body

application/problem+json

application/problem+json

application/problem+json

curl -X DELETE "https://example.com/v1/clients/497f6eca-6276-4993-bfeb-53cbbbba6f08/categories/497f6eca-6276-4993-bfeb-53cbbbba6f08"
Empty