---
title: "Changes to Create a Recovery Link"
method: POST
path: "/admin/recovery/link"
---

# Changes to Create a Recovery Link

`POST /admin/recovery/link`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 5 of 47 revisions.

- **2024-02-20** `4f071812f3ea`: 1 info
- **2023-01-14** `3f9901877db9`: 1 info
- **2022-12-02** `b6e5ffa30d4c`: 1 breaking, 4 info
- **2022-03-22** `028a4cf83c15`: 1 info
- **2021-05-05** `381c760af46e`: 1 breaking

## Changes

- **2024-02-20** `4f071812f3ea`: 1 info
  - added the new optional `query` request parameter `return_to`
- **2023-01-14** `3f9901877db9`: 1 info
  - the endpoint scheme security `oryAccessToken` was added to the API
- **2022-12-02** `b6e5ffa30d4c`: 1 breaking, 4 info
  - the `identity_id` request property format changed from `uuid4` to `uuid`
  - api operation id `adminCreateSelfServiceRecoveryLink` removed and replaced with `createRecoveryLinkForIdentity`
  - api tag `identity` added
  - api tag `v0alpha2` removed
  - removed the non-success response with the status `500`
- **2022-03-22** `028a4cf83c15`: 1 info
  - endpoint added
- **2021-05-05** `381c760af46e`: 1 breaking
  - api path removed without deprecation

---

[Operation](https://skmtc.dev/ory/apis/ory-identities-api/docs/admin/recovery/link/post.md) - [API](https://skmtc.dev/ory/apis/ory-identities-api.md) - [Page](https://skmtc.dev/ory/apis/ory-identities-api/changes/admin/recovery/link/post)