---
title: "Update entity"
method: PATCH
path: "/accounting/v2beta/gl-entities/{id}"
tags: ["GL Entities"]
---

# Update entity

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

Update a GL entity.

## Path parameters

- `id` string, required

## Headers

- `If-Match` string

## Response `202`

The updated entity.

- GLEntity — A GL entity represents a legal entity in your ERP system. It can have a one-to-one relationship with an Atlar Entity.
  - `currency` string — Three-letter ISO 4217 currency code.
  - `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.
  - `entityId` string — Unique resource identifier.
  - `thirdPartyId` string — ID of the associated third-party, e.g. the ERP in which the entity is held.
  - `associatedConnections` AssociatedConnection[]
    - `connectionId` string, required
  - `name` string, required — The name of the GL entity.
  - `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/revisions/9c5e194ccf5d/schema)