POST
/
apps
/
{app_id}
/
merchants
/
uninstall
/
bulk
curl --request POST \
  --url https://sandbox-api.violet.io/v1/apps/{app_id}/merchants/uninstall/bulk \
  --header 'Content-Type: application/json' \
  --data '{
  "merchant_ids": [
    123
  ]
}'
{
  "errors": [
    {
      "merchant_id": 10064,
      "message": "App install could not be found."
    },
    {
      "merchant_id": 10065,
      "message": "Merchant could not be found."
    }
  ]
}
  • A MERCHANT_DISCONNECTED webhook is emitted upon each successful merchant disconnection.
  • A STORE_DISCONNECTED notification will be sent to the Channel Dashboard upon each successful merchant disconnection.
  • 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.
  • For any failed disconnections, the response will include the affected Merchant IDs and their corresponding failure reasons.

Headers

X-Violet-Token
string
X-Violet-App-Secret
string
X-Violet-App-Id
integer

Path Parameters

app_id
integer
required

Body

application/json

A Request to disconnect multiple merchants from an app

Response

200 - application/json
successful operation

The response is of type any.