---
title: "Add an also-known-as entry"
method: POST
path: "/identifiers/{did}/also-known-as"
tags: ["AlsoKnownAs"]
---

# Add an also-known-as entry

`POST /identifiers/{did}/also-known-as`

Adds an also-known-as URI. The request body is the shared
single-string body `{ "value": "<URI>" }`; the response exposes the
value as `akaUri`.

## Parameters

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

## Request body

- AlsoKnownAsCreateRequest — Request body for adding an also-known-as resource. The implementation accepts the shared single-string body and maps `value` to the response field `akaUri`.
  - `value` string, required — The also-known-as URI.

## Response `201`

Also-known-as entry added successfully.

- AlsoKnownAsEntry — unresolved $ref

## Other responses

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

## Changes

- **2026-06-26** `a1581f6b71f3` — 1 breaking, 1 warning
  - added the new required request property `value`
  - removed the request property `akaUri`

[Change history](https://skmtc.dev/sphereon-opensource/apis/did-rest-api/changes/identifiers/:did/also-known-as/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)