---
title: "Update legal entity"
method: PUT
path: "/legal_entities/{legalEntityId}"
tags: ["Compliance"]
---

# Update legal entity

`PUT /legal_entities/{legalEntityId}`

## Request

- Base URL: `https://api.fireblocks.io/v1`
- URL: `https://api.fireblocks.io/v1/legal_entities/{legalEntityId}`
- Auth: none declared
- TypeScript: <https://skmtc.dev/fireblocks/apis/fireblocks-api/docs/legal_entities/:legalEntityId/put.ts> (a function with typed inputs; its response is checked against the schema)

Updates the status of a legal entity registration. Setting isDefault to true marks the registration as the workspace default, which is applied to vault accounts that have no explicit legal entity mapping.
Endpoint Permission: Admin, Non-Signing Admin.

## Path parameters

- `legalEntityId` string, uuid, required

## Headers

- `Idempotency-Key` string

## Request body

- UpdateLegalEntityRequest
  - `isDefault` boolean, required: Whether to set this registration as the workspace default

## Response `200`

Updated legal entity registration

- LegalEntityRegistration: Legal entity registration record
  - `id` string, uuid, required: Unique registration identifier
  - `lei` string, required: Legal Entity Identifier (LEI) code
  - `status` 'PENDING' | 'APPROVED' | 'DENIED' | 'REVOKED', required: Approval status of a legal entity registration
  - `isDefault` boolean, required: Whether this is the default legal entity for the workspace
  - `travelRuleProviders` TravelRuleProvider[], required: Travel rule providers configured for this registration
  - `travelRuleContactEmail` string, email: Contact email for travel rule communications
  - `gleifData` GleifData: GLEIF (Global Legal Entity Identifier Foundation) data for a legal entity
    - `lei` string, required: Legal Entity Identifier (LEI) code
    - `legalName` string, required: Official legal name of the entity
    - `legalNameLanguage` string: Two-letter ISO 639-1 language code
    - `otherNames` GleifOtherLegalEntityName[]: Alternative names for the entity
      - `name` string, required: Alternative name of the legal entity
      - `language` string, required: Two-letter ISO 639-1 language code
    - `legalAddressRegion` string: Region or state of the legal address
    - `legalAddressCountry` string, required: Country code of the legal address (ISO 3166-1 alpha-2)
    - `nextRenewalDate` string, date-time: Date when the LEI registration must be renewed
  - `createdAt` string, required: Creation timestamp in milliseconds since epoch
  - `updatedAt` string, required: Last update timestamp in milliseconds since epoch

## Other responses

- `400`: Registration is not in APPROVED status
- `404`: Legal entity registration not found
- `default`: Error Response

---

[API](https://skmtc.dev/fireblocks/apis/fireblocks-api.md) - [All operations](https://skmtc.dev/fireblocks/apis/fireblocks-api/llms.txt) - [OpenAPI document](https://skmtc.dev/fireblocks/apis/fireblocks-api/revisions/4eba9965659a?raw)