Skip to main content
DELETE
/
v1
/
vendors
/
{vendorId}
Delete Vendor
curl --request DELETE \
  --url https://api.puppetvendors.com/v1/vendors/{vendorId} \
  --header 'x-access-token: <api-key>'

​
Overview

Marks a vendor as hidden. The vendor record is not permanently deleted and will no longer appear in list queries.

​
Use Cases

  • Offboard a vendor who is no longer active
  • Deactivate vendors programmatically from an admin tool

​
Path Parameters

​
vendorId
string
required
The vendor’s unique ID.

​
Response

200
{
  "message": "Vendor deleted successfully.",
  "vendor": { ... }
}
This is a soft delete. The vendor’s historical data (orders, payouts, reports) is preserved. The vendor will be excluded from all list endpoints.

​
Example

curl -X DELETE "https://api.puppetvendors.com/v1/vendors/6157faecbebcf01bf49097d9" \
  -H "x-access-token: YOUR_JWT_TOKEN"