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

Authorization<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.

In: header

Path Parameters

companyId*string
Length1 <= length

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

curl -X POST "https://example.com/companies/string/categories/batch_delete" \  -H "Content-Type: application/json" \  -d '{    "categoryIds": [      "string"    ]  }'
{  "success": true}

Update category

Update a category's name, emoji, plTypes, or order. Only the fields you send change. Narrowing plTypes does not rewrite transactions already categorized…

Merge

Merge several categories into one, in a single transaction. Creates the category described by newCategory, then repoints everything that referenced the old…