---
title: "POST /entity/moveTo"
method: POST
path: "/entity/moveTo"
tags: ["Entity"]
---

# POST /entity/moveTo

`POST /entity/moveTo`

Move existing entities to the target collection.

## Query parameters

- `collectionId` string, required
- `api-version` string, required

## Request body

- MoveEntitiesRequest
  - `entityGuids` string[] — An array of entity guids to be moved to target collection.

## Response `200`

Created with EntityMutationResponse.

- EntityMutationResponse — The mutation response of entity.
  - `guidAssignments` object — A map of GUID assignments with entities.
  - `mutatedEntities` object — The entity headers of mutated entities.
  - `partialUpdatedEntities` AtlasEntityHeader[] — An array of entity headers that partially updated.
    - `attributes` object — The attributes of the struct.
    - `typeName` string — The name of the type.
    - `lastModifiedTS` string — ETag for concurrency control.

## Other responses

- `default` — Error response describing why the operation failed.

## Changes

- **2026-07-13** (2023-09-01) `5afce6b3aae1` — 1 info
  - api tag `Entity` added

[Change history](https://skmtc.dev/azure/apis/purview-datamap/changes/entity/moveTo/post.md)

---

[API](https://skmtc.dev/azure/apis/purview-datamap.md) · [All operations](https://skmtc.dev/azure/apis/purview-datamap/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azure/purview-datamap/revisions/5afce6b3aae1/schema)