---
title: "PUT /atlas/v2/entity/guid/{guid}"
method: PUT
path: "/atlas/v2/entity/guid/{guid}"
---

# PUT /atlas/v2/entity/guid/{guid}

`PUT /atlas/v2/entity/guid/{guid}`

Update entity partially - create or update entity attribute identified by its
GUID.
Supports only primitive attribute type and entity references.
It does not support updating complex types like arrays, and maps.
Null updates are not possible.

## Path parameters

- `guid` string, required

## Query parameters

- `name` string, required

## Request body

- unknown

## Response `200`

The request has succeeded.

- EntityMutationResult — The mutation response result 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.
    - `classificationNames` string[] — An array of classification names.
    - `classifications` AtlasClassification[] — An array of classifications.
      - `attributes` object — The attributes of the struct.
      - `typeName` string — The name of the type.
      - `lastModifiedTS` string — ETag for concurrency control.
      - `entityGuid` string — The GUID of the entity.
      - `entityStatus` 'ACTIVE' | 'DELETED' — Status - can be active or deleted
      - `removePropagationsOnEntityDelete` boolean — Determines if propagations will be removed on entity deletion.
      - `validityPeriods` TimeBoundary[] — An array of time boundaries indicating validity periods.
        - `endTime` string — The end of the time boundary.
        - `startTime` string — The start of the time boundary.
        - `timeZone` string — The timezone of the time boundary.
    - `displayText` string — The display text.
    - `guid` string — The GUID of the record.
    - `isIncomplete` boolean — Whether it is a shell entity
    - `labels` string[] — labels
    - `meaningNames` string[] — An array of meanings.
    - `meanings` AtlasTermAssignmentHeader[] — An array of term assignment headers.
      - `confidence` integer — The confidence of the term assignment.
      - `createdBy` string — The user who created the record.
      - `description` string — The description of the term assignment.
      - `displayText` string — The display text.
      - `expression` string — The expression of the term assignment.
      - `relationGuid` string, uuid — Universally Unique Identifier
      - `status` 'DISCOVERED' | 'PROPOSED' | 'IMPORTED' | 'VALIDATED' | 'DEPRECATED' | 'OBSOLETE' | 'OTHER' — Status for term assignment
      - `steward` string — The steward of the term.
      - `termGuid` string, uuid — Universally Unique Identifier
    - `status` 'ACTIVE' | 'DELETED' — Status - can be active or deleted

## Other responses

- `default` — An unexpected error response.

---

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