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

# POST /atlas/v2/relationship

`POST /atlas/v2/relationship`

Create a new 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.

## Changes

- **2026-07-13** (2023-09-01) `442226cb14a9` — 1 info
  - api tag `Relationship` removed
- **2026-07-13** (2023-09-01) `5afce6b3aae1` — 1 info
  - api tag `Relationship` added

[Change history](https://skmtc.dev/azure/apis/purview-datamap/changes/atlas/v2/relationship/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/442226cb14a9/schema)