---
title: "Add a verification relationship"
method: POST
path: "/identifiers/{did}/verification-relationships"
tags: ["VerificationRelationships"]
---

# Add a verification relationship

`POST /identifiers/{did}/verification-relationships`

Binds an existing verification method to a verification relationship
purpose. The default is a referenced relationship; set `embed` to true
to serialize the relationship as an inline verification method object.

## Parameters

- `./common-components.yml#/components/parameters/CorrelationId` — unresolved $ref

## Request body

- object
  - `verificationMethodId` string, required — The verification method id (or fragment) to bind.
  - `purpose` string, required — One of authentication, assertionMethod, keyAgreement, capabilityInvocation, capabilityDelegation.
  - `embed` boolean — Render this relationship as an embedded verification method instead of a DID URL reference.

## Response `201`

Verification relationship added successfully.

- VerificationRelationship — unresolved $ref

## Other responses

- `401` — unresolved $ref
- `403` — unresolved $ref
- `404` — unresolved $ref
- `422` — unresolved $ref
- `500` — unresolved $ref

## Changes

- **2026-06-26** `a1581f6b71f3` — 1 info
  - added the new optional request property `embed`

[Change history](https://skmtc.dev/sphereon-opensource/apis/did-rest-api/changes/identifiers/:did/verification-relationships/post.md)

---

[API](https://skmtc.dev/sphereon-opensource/apis/did-rest-api.md) · [All operations](https://skmtc.dev/sphereon-opensource/apis/did-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sphereon-opensource/did-rest-api/revisions/d575fc307e80/schema)