# Aliases

User alias management for account migration and identity linking. Aliases allow a user to declare previous identities on remote federated servers, which is required for ActivityPub account migration. All endpoints require authentication.

## List of aliases

 - [GET /api/v1/user-alias](https://docs.wellesley.social/openapi/aliases/paths/~1api~1v1~1user-alias/get.md): Returns all aliases registered for the authenticated user as a list of ActivityPub URIs. Requires authentication.

## Remove alias

 - [DELETE /api/v1/user-alias](https://docs.wellesley.social/openapi/aliases/paths/~1api~1v1~1user-alias/delete.md): Removes an existing alias from the authenticated user by its ActivityPub URI. Requires authentication.

## Create alias

 - [POST /api/v1/user-alias](https://docs.wellesley.social/openapi/aliases/paths/~1api~1v1~1user-alias/post.md): Adds a remote account alias for the authenticated user. The acct parameter must include a domain (e.g., 'user@remote.social'). The remote actor is fetched and verified via ActivityPub before the alias is saved. Used to declare a previous identity for account migration. Requires authentication.