Skip to main content
PATCH
Update a cash flow category
Authentication: API key OAuth 2.0
Scope: cash_flow_category.write
The request fails with invalid_id for a malformed ID, empty_name or name_too_long for an invalid name, invalid_type for an unsupported category direction, name_already_used when the name already exists, or default_category_not_editable for a default category. It returns category_not_found when the ID does not belong to the authenticated organization.

Authorizations

Authorization
string
header
required

Bearer authorization header: Bearer <token>, where <token> is the access token received from the authorization server at the end of the OAuth 2.0 flow.

Headers

X-Qonto-Staging-Token
string

Required only for Sandbox API requests; to get one, please sign up to the Developer Portal.

Path Parameters

id
string<uuid>
required

ID of the category or subcategory to update

Body

application/json
name
string

New display name. Must be non-empty and within the category name length limit.

type
enum<string>

New direction for a top-level category. Ignored for subcategories.

  • CATEGORY_TYPE_INFLOW: money coming in
  • CATEGORY_TYPE_OUTFLOW: money going out
Available options:
CATEGORY_TYPE_INFLOW,
CATEGORY_TYPE_OUTFLOW

Response

Returns the updated category or subcategory.

cash_flow_category
object
required