SaaSFlow
DevelopersAPIReferencevendors

Batch delete

Delete many vendors in one call. selection works two ways: mode: "ids" with an explicit list, or mode: "filter" with the same q the list endpoint takes…

Authentication

Checking whether you're signed in…
POST
/companies/{companyId}/vendors/batch_delete

Authorization

headerAuthorization<token>

A SaaSFlow API key (format sf_…) or an OAuth bearer token. Paste only the key — the proxy adds the Bearer prefix. Create an API key in Settings → Company settings → API keys — see API keys.

Path Parameters

companyId*string
Length1 <= length

Request Body

application/json
  1. body
selection*|

Response Body

Vendors deleted

application/json
  1. response
success*boolean
affected*integer
Range0 <= value
curl -X POST "https://example.com/companies/string/vendors/batch_delete" \  -H "Content-Type: application/json" \  -d '{    "selection": {      "mode": "ids",      "ids": [        "string"      ]    }  }'
{  "success": true,  "affected": 0}

Apply default categorization

Re-apply a vendor's default categorization to transactions already booked against it. applyTo decides how far it reaches: empty only fills in transactions…

Merge

Merge duplicate vendors into one. Creates the vendor described in the body, repoints the transactions and external ids of every id in vendorIds onto it…