SaaSFlow
DevelopersAPIReferencecategories

Delete category

Delete a category. Refused with 409 while any transaction is still categorized under it or any planned transaction still uses it, and with 400 for system…

Authentication

Checking whether you're signed in…
DELETE
/companies/{companyId}/categories/{categoryId}

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
categoryId*string
Length1 <= length

Response Body

Category deleted

application/json
  1. response
success*boolean
curl -X DELETE "https://example.com/companies/string/categories/string"
{  "success": true}

Retrieve category

Retrieve a single category by id. Returns 404 if the category does not exist or belongs to another company.

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…