---
title: "Assign vault accounts to a legal entity"
method: POST
path: "/legal_entities/{legalEntityId}/vaults"
tags: ["Compliance"]
---

# Assign vault accounts to a legal entity

`POST /legal_entities/{legalEntityId}/vaults`

## Request

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

Assigns one or more vault accounts to a specific legal entity registration. Explicitly mapped vault accounts take precedence over the workspace default legal entity.
Endpoint Permission: Admin, Non-Signing Admin.

## Path parameters

- `legalEntityId` string, uuid, required

## Headers

- `Idempotency-Key` string

## Request body

- AssignVaultsToLegalEntityRequest: Request body to assign vault accounts to a legal entity
  - `vaultAccountIds` string[], required: List of vault account IDs to assign to the legal entity

## Response `201`

Vault accounts assigned successfully

- AssignVaultsToLegalEntityResponse: Response after assigning vault accounts to a legal entity
  - `assignedCount` integer, required: Number of vault accounts successfully assigned

## Other responses

- `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)