# Overwrite an entity (replace addresses)

Updates an entity by overwriting its details and full address set. The complete JSON input must include the updated entity fields plus a multi‑chain addresses mapping. The addresses object is keyed by blockchain type (for example, evm, bitcoin, solana, etc.) and each value is an array of address strings.

Important: Any existing addresses not present in the payload will be removed. Use /user/entities/only_add/{id} if you want to keep existing addresses and only append new ones.

Example Input Explanation:
- name / note: Optional text fields. name is limited to 256 characters; note to 1024 characters.
- addresses: Map of chain to array of addresses.
- Bulk updates allow up to 100 total addresses per entity. Ensure addresses are valid and formatted correctly.

Endpoint: PUT /user/entities/{id}
Version: 1.0.0
Security: ApiKeyAuth

## Path parameters:

  - `id` (string, required)
    Unique identifier of the entity to update. You can grab it from your url https://intel.arkm.com/explorer/entity/{entityId}

## Request fields (application/json):

  - `name` (string, required)
    Example: "Example Name"

  - `note` (string)
    Example: "Updated note"

  - `id` (string, required)
    Example: "exampleID"

  - `type` (string,null)

  - `service` (boolean,null)

  - `addresses` (object)
    Example: {"evm":["0xC17eF7e2689DFf7D269Ae2C22f857AcD60B42187","0x7dCC00d0Da47e6982672CB1C2481A6943737af45"],"bitcoin":["bc1qd7m42p9w8djak3qeme06stw7ach7hewa88rd6q0rgegw3mdlpl5s5wje56"],"solana":["H6r6ShBfuoVYCCb8ZJANFYfR4y1EXr4vTLYPKbmHGxtv"],"tron":["TLBsPRBS6WeB6DyzKSNhKXHxaWESeoK44g"]}

  - `ownerUID` (string)
    Example: "exampleOwnerId"

  - `linkShareable` (boolean)

  - `createdAt` (string)
    Example: "2019-07-12T11:18:33Z"

  - `updatedAt` (string)
    Example: "2019-07-12T12:47:55Z"

## Response 400 fields (application/json):

  - `error` (string)
    Example: "Bad request"

## Response 401 fields (application/json):

  - `error` (string)
    Example: "API key missing or invalid"


## Response 500 fields