# Add a new relationship

Adds a relationship between two identities according to configured
relationship definitions.

Endpoint: POST /addRelationshipService
Version: 2026.1.2
Security: bearerAuth

## Request fields (application/json):

  - `auditId` (string)
    Audit identifier used for tracing and governance across Verato services.

  - `auditLogMap` (object)
    Generic map of string keys to string values.

  - `content` (object)

  - `content.relationship` (object)
    Relationship between two identities.

  - `content.relationship.id` (string)

  - `content.relationship.relationshipVerb` (string)

  - `content.relationship.inverseRelationshipVerb` (string)

  - `content.relationship.subjectVeratoId` (string)

  - `content.relationship.objectVeratoId` (string)

  - `content.relationship.domain` (string)

  - `content.relationship.trustFactor` (string)

  - `content.relationship.details` (object)
    Generic map of string keys to arbitrary values.

  - `content.relationship.status` (string)

  - `content.relationship.startDate` (string)

  - `content.relationship.endDate` (string)

  - `trackingId` (string)

## Response 200 fields (application/json):

  - `auditId` (string)
    Audit identifier used for tracing and governance across Verato services.

  - `success` (boolean)

  - `unparsedJson` (string)

  - `warnings` (array)

  - `retryableError` (boolean)

  - `message` (string)

  - `content` (object)

  - `content.relationship` (object)
    Relationship between two identities.

  - `content.relationship.id` (string)

  - `content.relationship.relationshipVerb` (string)

  - `content.relationship.inverseRelationshipVerb` (string)

  - `content.relationship.subjectVeratoId` (string)

  - `content.relationship.objectVeratoId` (string)

  - `content.relationship.domain` (string)

  - `content.relationship.trustFactor` (string)

  - `content.relationship.details` (object)
    Generic map of string keys to arbitrary values.

  - `content.relationship.status` (string)

  - `content.relationship.startDate` (string)

  - `content.relationship.endDate` (string)

  - `errors` (array)

  - `trackingId` (string)