v1

latestOpenAPI 3.0.12026-07-24310590875.6 KB
classifications

Update a chart of accounts

Update details about an existing chart of accounts.

patch/v3/classifications/chart-of-accounts/{id}

Path parameters

idstring required

BILL-generated ID of the chart of accounts. The value begins with 0ca.

Example:{{chart_of_accounts_id}}

Headers

sessionIdstring nullable

API session ID generated with /v3/login

Example:{{session_id}}
devKeystring nullable

Developer key generated with your BILL developer account

Example:{{developer_key}}

Request body

namestring

Chart of accounts name

descriptionstring

Chart of accounts description

parentIdstring

BILL-generated ID of the parent chart of accounts. You can set this field if this chart of accounts is a child object.

Example request

{
  "name": "Prepaid Expenses",
  "description": "Prepaid expenses for Q4 2026",
  "account": {
    "type": "EXPENSE",
    "number": "1-020"
  }
}

Response

Update a chart of accounts response

idstring

BILL-generated ID of the chart of accounts. The value begins with 0ca.

archivedboolean

Set as true if the chart of accounts is archived

namestring

Chart of accounts name

descriptionstring

Chart of accounts description

parentIdstring

BILL-generated ID of the parent chart of accounts. You can set this field if this chart of accounts is a child object.

createdTimestring date-time

Created date and time

updatedTimestring date-time

Updated date and time