Archive a category
DELETE/api/v1/categories/:id
Archives a category by ID (soft delete via archived_at timestamp).
The category must belong to a tenant accessible by the OAuth application. Archived categories are excluded from active lists but remain accessible with include_archived=true.
Request
Responses
- 204
- 401
- 404
- 422
The category was archived (its archived_at timestamp was set). This is a soft delete, not a hard delete: the record is not removed and remains retrievable with include_archived=true.
The request did not include a valid OAuth 2.0 access token.
No category exists with the given id, or it belongs to a workspace the access token's OAuth application is not linked to.
A record still bound to the category blocks the archive: a webhook endpoint that would stop receiving deliveries, or an import category mapping that still files invoices under it. code is dependent_records and message names which of the two blocks it; unlike a validation failure this body carries no details. Rebind or delete the dependents first.