Update Account by ID

Endpoint: PUT /accounts/{id}

Authentication: Bearer Token (required)

Description

Updates the details of an existing account identified by its UUID. All relevant fields must be provided.

Request

Path Parameters

Name	Type	Required	Description
id	string	Yes	The UUID of the account to update

Headers

Name	Type	Required	Description
Content-Type	string	Yes	Must be application/json
Authorization	string	Yes	Bearer token for authentication

Request Body

{
  "name": "Pool Suspense Account",
  "description": "Suspense account for core system pool",
  "accountNumber": "1811300008",
  "alternateAccountNumber": null,
  "parentAccountId": null,
  "type": "ASSET",
  "category": "CURRENT",
  "ledger": "GL",
  "balance": null,
  "partyType": "COMPANY",
  "party": "Bookshop 4",
  "currencyStringId": "3940d6ac-cae7-465f-9a20-81408fc28913",
  "customer": null,
  "customerStringId": null,
  "companyStringId": "734a7dd8-b8ba-43df-9210-8bf0f367bca5"
}

Request Body Fields

Field	Type	Required	Description
name	string	Yes	The name of the account
description	string	No	A description of the account's purpose
accountNumber	string	No	The system-generated account number
alternateAccountNumber	string	No	An alternate identifier for the account
parentAccountId	string	No	The UUID of the parent account (for hierarchical accounts)
type	string	Yes	The account type. One of: ASSET, LIABILITY, EQUITY, REVENUE, EXPENSE
category	string	Yes	The account category. One of: CURRENT, NON_CURRENT, OPERATING, NON_OPERATING
ledger	string	Yes	The ledger type. Must be GL (General Ledger)
balance	number	No	The current balance of the account
partyType	string	Yes	The type of party associated with the account. One of: COMPANY, CUSTOMER, SUPPLIER
party	string	Yes	The name of the party associated with the account
currencyStringId	string	Yes	The UUID of the currency for the account
customer	object	No	The customer object associated with the account
customerStringId	string	No	The UUID of the customer (required if partyType is CUSTOMER)
companyStringId	string	Yes	The UUID of the company that owns the account