> ## Documentation Index
> Fetch the complete documentation index at: https://developers.fireblocks.com/llms.txt
> Use this file to discover all available pages before exploring further.

<AgentInstructions>

## Submitting Feedback

If you encounter incorrect, outdated, or confusing documentation on this page, submit feedback:

POST https://developers.fireblocks.com/feedback

```json
{
  "path": "/api-reference/compliance/update-legal-entity",
  "feedback": "Description of the issue"
}
```

Only submit feedback when you have something specific and actionable to report.

</AgentInstructions>

# Update legal entity

> 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.



## OpenAPI

````yaml https://docs.fireblocks.com/api/v1/swagger.yaml put /legal_entities/{legalEntityId}
openapi: 3.0.0
info:
  title: Fireblocks API
  description: >
    Fireblocks provides a suite of applications to manage digital asset
    operations and a complete development platform to build your business on the
    blockchain.


    - Visit our website for more information: [Fireblocks
    Website](https://fireblocks.com)

    - Visit our developer docs: [Fireblocks
    DevPortal](https://developers.fireblocks.com)
  version: 1.6.2
  contact:
    email: developers@fireblocks.com
servers:
  - url: https://api.fireblocks.io/v1
    description: Fireblocks Production Environment Base URL
  - url: https://sandbox-api.fireblocks.io/v1
    description: Fireblocks Sandbox Environment Base URL
security: []
paths:
  /legal_entities/{legalEntityId}:
    put:
      tags:
        - Compliance
      summary: Update legal entity
      description: >-
        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.
      operationId: updateLegalEntity
      parameters:
        - in: path
          name: legalEntityId
          required: true
          description: The unique ID of the legal entity registration
          schema:
            type: string
            format: uuid
        - $ref: '#/components/parameters/X-Idempotency-Key'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateLegalEntityRequest'
      responses:
        '200':
          description: Updated legal entity registration
          headers:
            X-Request-ID:
              $ref: '#/components/headers/X-Request-ID'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LegalEntityRegistration'
        '400':
          description: Registration is not in APPROVED status
          headers:
            X-Request-ID:
              $ref: '#/components/headers/X-Request-ID'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorSchema'
        '404':
          description: Legal entity registration not found
          headers:
            X-Request-ID:
              $ref: '#/components/headers/X-Request-ID'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorSchema'
        default:
          $ref: '#/components/responses/Error'
      x-codeSamples:
        - lang: TypeScript
          source: >-
            const response: Promise<FireblocksResponse<LegalEntityRegistration>>
            =
            fireblocks.compliance.updateLegalEntity(complianceApiUpdateLegalEntityRequest);
        - lang: Java
          source: >-
            CompletableFuture<ApiResponse<LegalEntityRegistration>> response =
            fireblocks.compliance().updateLegalEntity(updateLegalEntityRequest,
            legalEntityId, idempotencyKey);
        - lang: Python
          source: >-
            response =
            fireblocks.compliance.update_legal_entity(update_legal_entity_request,
            legal_entity_id, idempotency_key);
components:
  parameters:
    X-Idempotency-Key:
      name: Idempotency-Key
      in: header
      description: >-
        A unique identifier for the request. If the request is sent multiple
        times with the same idempotency key, the server will return the same
        response as the first request. The idempotency key is valid for 24
        hours.
      required: false
      schema:
        type: string
  schemas:
    UpdateLegalEntityRequest:
      type: object
      required:
        - isDefault
      properties:
        isDefault:
          type: boolean
          description: Whether to set this registration as the workspace default
    LegalEntityRegistration:
      type: object
      description: Legal entity registration record
      properties:
        id:
          type: string
          format: uuid
          description: Unique registration identifier
          example: 550e8400-e29b-41d4-a716-446655440000
        lei:
          type: string
          description: Legal Entity Identifier (LEI) code
          example: 529900HNOAA1KXQJUQ27
        status:
          $ref: '#/components/schemas/LeiStatus'
        isDefault:
          type: boolean
          description: Whether this is the default legal entity for the workspace
          example: false
        travelRuleProviders:
          type: array
          minItems: 0
          maxItems: 20
          items:
            $ref: '#/components/schemas/TravelRuleProvider'
          description: Travel rule providers configured for this registration
          example:
            - MY_OWN
        travelRuleContactEmail:
          type: string
          format: email
          description: Contact email for travel rule communications
          example: compliance@example.com
        gleifData:
          $ref: '#/components/schemas/GleifData'
        createdAt:
          type: string
          description: Creation timestamp in milliseconds since epoch
          example: '1700000000000'
        updatedAt:
          type: string
          description: Last update timestamp in milliseconds since epoch
          example: '1700000000000'
      required:
        - id
        - lei
        - tenantId
        - status
        - isDefault
        - travelRuleProviders
        - createdAt
        - updatedAt
    ErrorSchema:
      type: object
      properties:
        message:
          type: string
        code:
          type: number
    LeiStatus:
      type: string
      description: Approval status of a legal entity registration
      enum:
        - PENDING
        - APPROVED
        - DENIED
        - REVOKED
    TravelRuleProvider:
      type: string
      description: Travel rule compliance provider
      enum:
        - CODE
        - GTR
        - MY_OWN
        - NOTABENE
        - SYGNA
        - SUMSUB
        - TRISA
        - TRUST
        - TWENTY_ONE_ANALYTICS
        - VERIFY_VASP
    GleifData:
      type: object
      description: >-
        GLEIF (Global Legal Entity Identifier Foundation) data for a legal
        entity
      properties:
        lei:
          type: string
          description: Legal Entity Identifier (LEI) code
          example: 529900HNOAA1KXQJUQ27
        legalName:
          type: string
          description: Official legal name of the entity
          example: Example Corporation Ltd.
        legalNameLanguage:
          type: string
          description: Two-letter ISO 639-1 language code
          example: en
          minLength: 2
          maxLength: 2
        otherNames:
          type: array
          minItems: 0
          maxItems: 20
          items:
            $ref: '#/components/schemas/GleifOtherLegalEntityName'
          description: Alternative names for the entity
          example:
            - name: ExCorp
              language: en
            - name: Example Corp
              language: en
        legalAddressRegion:
          type: string
          description: Region or state of the legal address
          example: NY
        legalAddressCountry:
          type: string
          description: Country code of the legal address (ISO 3166-1 alpha-2)
          example: US
        nextRenewalDate:
          type: string
          format: date-time
          description: Date when the LEI registration must be renewed
          example: '2025-12-31T00:00:00Z'
      required:
        - lei
        - legalName
        - legalAddressCountry
    GleifOtherLegalEntityName:
      type: object
      properties:
        name:
          type: string
          description: Alternative name of the legal entity
          example: ExCorp
        language:
          type: string
          description: Two-letter ISO 639-1 language code
          example: en
      required:
        - name
        - language
  headers:
    X-Request-ID:
      schema:
        type: string
      description: >-
        Unique ID correlated to the API request. Please provide it in any
        support ticket you create or on Github issues related to Fireblocks SDKs
  responses:
    Error:
      description: Error Response
      headers:
        X-Request-ID:
          $ref: '#/components/headers/X-Request-ID'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorSchema'

````