---
title: "Updates the legal entity of the account"
method: POST
path: "/v1.0/installation/accounts/{id}/legal-entity"
tags: ["Installation account update"]
---

# Updates the legal entity of the account

`POST /v1.0/installation/accounts/{id}/legal-entity`

## Path parameters

- `id` integer, required

## Request body

- LegalEntityDTO
  - `id` integer
  - `type` 'LIMITED_COMPANY' | 'PARTNERSHIP' | 'SOLE_TRADER' | 'OTHER'
  - `name` string
  - `referenceNumber` string
  - `noReferenceNumberReason` string
  - `address` AddressDTO
    - `line1` string, required
    - `line2` string
    - `city` string, required
    - `country` string, required
    - `postcode` string, required
  - `holdingCompany` HoldingCompanyDTO
    - `name` string, required
    - `registrationNumber` string
    - `address` HoldingCompanyAddressDTO, required
      - `line1` string, required
      - `line2` string
      - `city` string, required
      - `postcode` string, required

## Response `200`

OK

## Other responses

- `403` — Forbidden
- `404` — Not Found
- `500` — Internal Server Error

## Changes

- **2025-11-18** `75eb25c6c016` — 3 warning
  - removed the optional property `security` from the response with the `403` status
  - removed the optional property `security` from the response with the `404` status
  - removed the optional property `security` from the response with the `500` status
- **2025-07-17** `ae162f3b8695` — 3 info
  - added the optional property `security` to the response with the `403` status
  - added the optional property `security` to the response with the `404` status
  - added the optional property `security` to the response with the `500` status

[Change history](https://skmtc.dev/beis/apis/mets-api-documentation/changes/v1.0/installation/accounts/:id/legal-entity/post.md)

---

[API](https://skmtc.dev/beis/apis/mets-api-documentation.md) · [All operations](https://skmtc.dev/beis/apis/mets-api-documentation/llms.txt) · [OpenAPI document](https://skmtc.dev/beis/apis/mets-api-documentation/revisions/5b71be5bb6ae?raw)