---
title: "Add vault accounts to the address registry opt-out list"
method: POST
path: "/address_registry/vaults"
tags: ["Compliance"]
---

# Add vault accounts to the address registry opt-out list

`POST /address_registry/vaults`

## Request

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

Adds one or more vault account ids to the workspace opt-out list for the address registry.

## Headers

- `Idempotency-Key` string

## Request body

- AddressRegistryAddVaultOptOutsRequest
  - `vaultAccountIds` union[], required: Vault account ids to add to the opt-out list (non-empty). Each element may be a JSON number or a decimal string; both forms are accepted.
    - union
      - integer
      - string

## Response `200`

Opt-outs recorded; response body includes `acceptedCount`.

- AddressRegistryAddVaultOptOutsResponse: Result of adding vault account ids to the workspace opt-out list for the address registry.
  - `acceptedCount` integer, required: Number of vault ids from the request that were processed. An empty `vaultAccountIds` list is rejected with HTTP 400, not a 200 with zero.

## Other responses

- `400`: Validation error (e.g. empty list or invalid vault ids)
- `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)