Update an account

PUThttps://app.speybooks.com/api/v1/accounts/{id}

Updates one or more fields on an existing account. Only the fields included in the request body are modified (partial update semantics).

System accounts can only have their isActive flag changed; any other modification is rejected. Account code changes are validated for uniqueness within the organisation.

Path parameters

idstringrequired
Prefixed account ID (e.g. acc_1200).

Body parameters

accountTypestringoptional
Account type. Cannot be changed on system accounts.
assetliabilityequityrevenueexpense
codestringoptional
New account code (max 20 characters). Must be unique within the organisation.
controlTypestringoptionalnullable
Control account type identifier (e.g. trade_debtors).
defaultVatRateintegeroptionalnullable
Default VAT rate as a whole percentage (e.g. 20 for 20%).
descriptionstringoptionalnullable
Updated description (max 500 characters).
isActivebooleanoptional
Whether the account is active. This is the only field editable on system accounts.
isControlAccountbooleanoptional
Whether this is a control account.
namestringoptional
New display name (max 200 characters).
parentIdstringoptionalnullable
Prefixed ID of the new parent account (e.g. acc_100), or null to make a root account.

Response

200Account updated successfully.
Show response fields
updatedboolean
Always true on success.

Error codes

400Validation failed, invalid ID format, or cannot modify system account.
404Account not found.
409An account with this code already exists in the organisation.