Skip to Content
SaaSFlow
DevelopersAPIReferencecategories

Batch delete

Delete several categories at once. All or nothing: if any id in the list is a system category, or still has transactions or planned transactions attached…

Authentication

Checking whether you're signed in…
POST
/companies/{companyId}/categories/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
Formatuuid

Request Body

application/json
  1. body
categoryIds*array<>

Response Body

Categories deleted

application/json
  1. response
success*boolean
Example Request
curl -X POST 'https://api.saasflow.com/companies/497f6eca-6276-4993-bfeb-53cbbbba6f08/categories/batch_delete' \  -H 'Content-Type: application/json' \  -d '{  "categoryIds": [    "string"  ]}'
Example Response
{  "success": true}