Merchant App Uninstall

• A MERCHANT_DISCONNECTED webhook is emitted upon successful merchant disconnection.

• A STORE_DISCONNECTED notification will be sent to the Channel Dashboard.

• Disconnecting will remove your access to the merchant's offers. To restore access in the future, the merchant will need to complete the Violet Connect process again.

Merchant App Uninstall

post

Send a request to uninstall (disconnect) a Merchant from the given App

Path parameters

app_idinteger · int32Required

Header parameters

X-Violet-TokenstringRequired

X-Violet-App-SecretstringRequired

X-Violet-App-Idinteger · int32Required

Body

application/json

A Request to uninstall/disconnect a merchant from an app

idinteger · int64Read-onlyOptional

app_idinteger · int32Optional

ID of the App to uninstall from

merchant_idinteger · int32Required

ID of Merchant being uninstalled

Responses

default

default response

application/json

Record of Application Install by a Merchant

idinteger · int64Read-onlyOptional

app_idinteger · int32Required

App ID

merchant_idinteger · int32Required

Merchant ID

scopestringOptional

Scope

statusstring · enumOptional

Status

Possible values:

install_sourcestring · enumOptional

Source of the App Install

Possible values:

commission_ratenumber · doubleOptional

Custom commission rate between the channel and supplier.

commission_lockedbooleanOptional

Indicates if the commission rate is locked or not. Commission rates can only be locked or unlocked by a Channel.

date_createdstring · date-timeRead-onlyOptional

Date of creation

date_last_modifiedstring · date-timeRead-onlyOptional

Date of last update

post/apps/{app_id}/merchants/uninstall

HTTPcURLJavaScriptPython

POST /v1/apps/{app_id}/merchants/uninstall HTTP/1.1
Host: sandbox-api.violet.io
X-Violet-Token: text
X-Violet-App-Secret: text
X-Violet-App-Id: 1
Content-Type: application/json
Accept: */*
Content-Length: 28

{
  "app_id": 1,
  "merchant_id": 1
}

default

default response

{
  "id": 1,
  "app_id": 1,
  "merchant_id": 1,
  "scope": "text",
  "status": "REQUESTED",
  "install_source": "DIRECT",
  "commission_rate": 1,
  "commission_locked": true,
  "date_created": "2026-07-14T05:40:49.881Z",
  "date_last_modified": "2026-07-14T05:40:49.881Z"
}