# Entity bulk update

Provides endpoints for updating custom entities in bulk. Entities can be fully overwritten (replacing details and address sets) or incrementally updated by adding new addresses without removing existing ones.

## Overwrite an entity (replace addresses)

 - [PUT /user/entities/{id}](https://docs.intel.arkm.com/openapi/entity-bulk-update/updateuserentity.md): 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.

## Bulk upload addresses for an entity (only add new addresses)

 - [PUT /user/entities/only_add/{id}](https://docs.intel.arkm.com/openapi/entity-bulk-update/updateuserentityonlyadd.md): Updates an entity by bulk uploading addresses. The full JSON input must include the updated entity
details along with 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.

Example Input Explanation:
- addresses: A map where each key is a chain identifier and the value is an array of valid hexadecimal
  addresses (or formatted address strings for non-EVM chains).
- Use the same JSON format regardless of whether the entity is a user entity or an Arkham entity.
- Bulk uploads allow up to 100 total addresses per entity. Make sure addresses are valid and formatted correctly.