---
title: "Partially update a DID"
method: PATCH
path: "/identifiers/{did}"
tags: ["Dids"]
---

# Partially update a DID

`PATCH /identifiers/{did}`

Follows JSON Merge Patch semantics: absent fields are ignored, and
explicitly setting a field to null removes it.

## Parameters

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

## Request body

- DidUpdateRequest — Request body for partially updating a DID.
  - `alias` string, nullable — Updated alias (null to clear).
  - `canonicalId` string, nullable — Updated canonical ID (null to clear).

## Response `200`

DID updated successfully.

- Did — unresolved $ref

## Other responses

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

---

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