Update a category
PATCH/categories/:id
Partial update of name and type only. Requires scope finance.categories.write. Re-parenting is not supported via v1. Changing a parent's type cascades to all descendants (internal behavior).
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 409
- 422
- 429
- 500
Updated category.
Malformed JSON body.
Missing / invalid / expired / revoked token.
Token lacks the finance.categories.write scope.
Category not found within the tenant.
X-Idempotency-Key reused with a different body.
Schema validation failure.
Rate limit exceeded for this token. Reads and writes have separate budgets, both on a 1-hour sliding window. The response carries X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset and Retry-After — wait out Retry-After rather than retrying immediately.
Unhandled server error.