---
title: "PUT /atlas/v2/relationship"
method: PUT
path: "/atlas/v2/relationship"
tags: ["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 an Atlas 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 an Atlas 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` number — Used to record the provenance of an instance of an entity or relationship
  - `status` 'ACTIVE' | 'DELETED' — The enum of relationship status.
  - `updateTime` integer — The update time of the record.
  - `updatedBy` string — The user who updated the record.
  - `version` number — The version of the relationship.

## Response `200`

OK. The relationship is updated.

- 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 an Atlas 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 an Atlas 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` number — Used to record the provenance of an instance of an entity or relationship
  - `status` 'ACTIVE' | 'DELETED' — The enum of relationship status.
  - `updateTime` integer — The update time of the record.
  - `updatedBy` string — The user who updated the record.
  - `version` number — The version of the relationship.

## 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)