---
title: "PUT /atlas/v2/entity/guid/{guid}"
method: PUT
path: "/atlas/v2/entity/guid/{guid}"
tags: ["Entity"]
---

# 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

- object

## Response `200`

Updated 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.
    - `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 of the entity - can be active or deleted. Deleted entities are not removed from Atlas store.
      - `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.
      - `source` string — indicate the source who create the classification detail
      - `sourceDetails` object — more detail on source information
    - `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 — The GUID of the relationship.
      - `source` string — The source of the term.
      - `status` 'DISCOVERED' | 'PROPOSED' | 'IMPORTED' | 'VALIDATED' | 'DEPRECATED' | 'OBSOLETE' | 'OTHER' — The status of terms assignment.
      - `steward` string — The steward of the term.
      - `termGuid` string — The GUID of the term.
    - `status` 'ACTIVE' | 'DELETED' — Status of the entity - can be active or deleted. Deleted entities are not removed from Atlas store.

## Other responses

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

---

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