---
title: "PUT /atlas/v2/relationship"
method: PUT
path: "/atlas/v2/relationship"
---

# PUT /atlas/v2/relationship

`PUT /atlas/v2/relationship`

Update an existing relationship between entities.

## Request body

- AtlasRelationship — Atlas relationship instance.
  - `attributes` object — The attributes of the struct.
  - `typeName` string — The name of the type.
  - `lastModifiedTS` string — ETag for concurrency control.
  - `createTime` integer — The created time of the record.
  - `createdBy` string — The user who created the record.
  - `end1` AtlasObjectId — Reference to an object-instance of a type - like entity.
    - `guid` string — The GUID of the object.
    - `typeName` string — The name of the type.
    - `uniqueAttributes` object — The unique attributes of the object.
  - `end2` AtlasObjectId — Reference to an object-instance of a type - like entity.
    - `guid` string — The GUID of the object.
    - `typeName` string — The name of the type.
    - `uniqueAttributes` object — The unique attributes of the object.
  - `guid` string — The GUID of the relationship.
  - `homeId` string — The home ID of the relationship.
  - `label` string — The label of the relationship.
  - `provenanceType` integer — Used to record the provenance of an instance of an entity or relationship
  - `status` 'ACTIVE' | 'DELETED' — Status for atlas relationship
  - `updateTime` integer — The update time of the record.
  - `updatedBy` string — The user who updated the record.
  - `version` integer — The version of the relationship.

## Response `200`

The request has succeeded.

- AtlasRelationship — Atlas relationship instance.
  - `attributes` object — The attributes of the struct.
  - `typeName` string — The name of the type.
  - `lastModifiedTS` string — ETag for concurrency control.
  - `createTime` integer — The created time of the record.
  - `createdBy` string — The user who created the record.
  - `end1` AtlasObjectId — Reference to an object-instance of a type - like entity.
    - `guid` string — The GUID of the object.
    - `typeName` string — The name of the type.
    - `uniqueAttributes` object — The unique attributes of the object.
  - `end2` AtlasObjectId — Reference to an object-instance of a type - like entity.
    - `guid` string — The GUID of the object.
    - `typeName` string — The name of the type.
    - `uniqueAttributes` object — The unique attributes of the object.
  - `guid` string — The GUID of the relationship.
  - `homeId` string — The home ID of the relationship.
  - `label` string — The label of the relationship.
  - `provenanceType` integer — Used to record the provenance of an instance of an entity or relationship
  - `status` 'ACTIVE' | 'DELETED' — Status for atlas relationship
  - `updateTime` integer — The update time of the record.
  - `updatedBy` string — The user who updated the record.
  - `version` integer — The version of the relationship.

## 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/versions/442226cb14a9/schema)