---
title: "Update account"
method: PATCH
path: "/accounting/v2beta/gl-accounts/{id}"
tags: ["GL Accounts"]
---

# Update account

`PATCH /accounting/v2beta/gl-accounts/{id}`

Update a general ledger account.

## Path parameters

- `id` string, required

## Headers

- `If-Match` string

## Response `202`

The updated general ledger account.

- GLAccount — A GL account represents a general ledger account in your ERP system. It can belong to one or many GL entities. When the account is of type BANK, it can have a one-to-one relationship with an Atlar financial-data account.
  - `id` string, required — Unique resource identifier.
  - `externalId` string, required — External ID is optional to use, but if used, the Atlar platform will persist it, index it, as well as require it to be unique across all resources. It is possible to retrieve a resource using the external ID using the prefix `external:`.
  - `organizationId` string, required — Unique resource identifier for an Organization.
  - `thirdPartyId` string — ID of the associated third-party, e.g. the ERP in which the account is held.
  - `associatedConnections` AssociatedConnection[]
    - `connectionId` string, required
  - `accountId` string — Unique resource identifier.
  - `glEntityIds` string[], required — The Atlar general ledger entity ids that this general ledger account is associated with.
  - `name` string, required — The name of the general ledger account.
  - `number` string — The number of the general ledger account.
  - `currency` string — Three-letter ISO 4217 currency code.
  - `type` 'UNSPECIFIED' | 'BANK' | 'ACCOUNTS_PAYABLE' | 'ACCOUNTS_RECEIVABLE' — The general ledger account types are not uniform across other third-party systems. However, it is useful to have a consistent type for the general ledger account. For example, to suggest accounts one can match with a bank account.
  - `displayType` string, required — The general ledger account types are not uniform across other third-party systems. So instead, we accept the raw type from the third-party system that we can display to the user.
  - `ignored` boolean, required — Whether the account is ignored in the accounting system.
  - `version` integer, required — Resource version. Starts at value `1` when the resource is created and increases by one for each successive update.
  - `etag` string, required — [ETag](https://en.wikipedia.org/wiki/HTTP_ETag) based on the resource version. This can be passed along in `If-Match` HTTP header when updating a resource to perform a conditional update.
  - `created` string, date-time, required — Time at which the resource was created.
  - `updated` string, date-time, required — Time at which the resource was last updated.

## Other responses

- `400` — Bad request.
- `404` — Resource not found.

---

[API](https://skmtc.net/atlar/apis/atlar-api-v2.md) · [All operations](https://skmtc.net/atlar/apis/atlar-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/atlar/atlar-api-v2/versions/9c5e194ccf5d/schema)