--- title: "Changes to Update Recovery Flow" method: POST path: "/self-service/recovery" --- # Changes to Update Recovery Flow `POST /self-service/recovery` > Every recorded change to this endpoint, newest first. ## Timeline Changed in 15 of 47 revisions. - **2025-11-07** `5f08e5827b5e` — 2 breaking, 4 warning, 50 info - **2025-02-25** `df2fe8db7397` — 4 breaking, 6 warning, 10 info - **2024-06-05** `344e70f3542d` — 52 warning, 8 info - **2024-02-20** `4f071812f3ea` — 2 breaking, 8 info - **2023-04-29** `2e602390c3aa` — 5 breaking, 7 warning, 9 info - **2022-12-02** `b6e5ffa30d4c` — 4 breaking, 62 warning, 13 info - **2022-06-01** `fca041c7721f` — 1 breaking, 26 warning, 7 info - **2022-03-25** `7402181057bd` — 1 info - **2022-03-22** `028a4cf83c15` — 8 info - **2021-10-28** `c55ed8ad9f0c` — 2 breaking, 27 info - **2021-09-12** `990ebe0a8820` — 2 breaking - **2021-07-22** `071bec03ddcd` — 4 breaking, 2 info - **2021-07-13** `8f1b399ab6e6` — 2 breaking, 3 warning, 10 info - **2021-05-18** `9123bcead5ed` — 2 info - **2021-05-05** `381c760af46e` — 18 breaking, 11 warning, 62 info ## Changes - **2025-11-07** `5f08e5827b5e` — 2 breaking, 4 warning, 50 info - added `#/components/schemas/uiNodeDivisionAttributes` to the `ui/nodes/items/attributes` response property `oneOf` list for the response status `200` - added `#/components/schemas/uiNodeDivisionAttributes` to the `ui/nodes/items/attributes` response property `oneOf` list for the response status `400` - added the new `div` enum value to the `ui/nodes/items/type` response property for the response status `200` - added the new `div` enum value to the `ui/nodes/items/type` response property for the response status `400` - added the new `username webauthn` enum value to the `ui/nodes/items/attributes/oneOf[#/components/schemas/uiNodeInputAttributes]/autocomplete` response property for the response status `200` - added the new `username webauthn` enum value to the `ui/nodes/items/attributes/oneOf[#/components/schemas/uiNodeInputAttributes]/autocomplete` response property for the response status `400` - added the new optional request property `oneOf[#/components/schemas/updateRecoveryFlowWithCodeMethod]/recovery_address` (media type: application/json) - added the new optional request property `oneOf[#/components/schemas/updateRecoveryFlowWithCodeMethod]/recovery_address` (media type: application/x-www-form-urlencoded) - added the new optional request property `oneOf[#/components/schemas/updateRecoveryFlowWithCodeMethod]/recovery_confirm_address` (media type: application/json) - added the new optional request property `oneOf[#/components/schemas/updateRecoveryFlowWithCodeMethod]/recovery_confirm_address` (media type: application/x-www-form-urlencoded) - added the new optional request property `oneOf[#/components/schemas/updateRecoveryFlowWithCodeMethod]/recovery_select_address` (media type: application/json) - added the new optional request property `oneOf[#/components/schemas/updateRecoveryFlowWithCodeMethod]/recovery_select_address` (media type: application/x-www-form-urlencoded) - added the new optional request property `oneOf[#/components/schemas/updateRecoveryFlowWithCodeMethod]/screen` (media type: application/json) - added the new optional request property `oneOf[#/components/schemas/updateRecoveryFlowWithCodeMethod]/screen` (media type: application/x-www-form-urlencoded) - added `div` discriminator mapping keys to the `ui/nodes/items/attributes` response property for the response status `200` - added `div` discriminator mapping keys to the `ui/nodes/items/attributes` response property for the response status `400` - removed the `a` enum value from the `ui/nodes/items/attributes/oneOf[#/components/schemas/uiNodeInputAttributes]/node_type` response property for the response status `200` - removed the `a` enum value from the `ui/nodes/items/attributes/oneOf[#/components/schemas/uiNodeInputAttributes]/node_type` response property for the response status `400` - removed the `a` enum value from the `ui/nodes/items/attributes/oneOf[subschema #2: TextAttributes represents the attributes of a text node.]/node_type` response property for the response status `200` - removed the `a` enum value from the `ui/nodes/items/attributes/oneOf[subschema #2: TextAttributes represents the attributes of a text node.]/node_type` response property for the response status `400` - removed the `a` enum value from the `ui/nodes/items/attributes/oneOf[subschema #3: ImageAttributes represents the attributes of an image node.]/node_type` response property for the response status `200` - removed the `a` enum value from the `ui/nodes/items/attributes/oneOf[subschema #3: ImageAttributes represents the attributes of an image node.]/node_type` response property for the response status `400` - removed the `a` enum value from the `ui/nodes/items/attributes/oneOf[subschema #5: ScriptAttributes represent script nodes which load javascript.]/node_type` response property for the response status `200` - removed the `a` enum value from the `ui/nodes/items/attributes/oneOf[subschema #5: ScriptAttributes represent script nodes which load javascript.]/node_type` response property for the response status `400` - removed the `img` enum value from the `ui/nodes/items/attributes/oneOf[#/components/schemas/uiNodeInputAttributes]/node_type` response property for the response status `200` - removed the `img` enum value from the `ui/nodes/items/attributes/oneOf[#/components/schemas/uiNodeInputAttributes]/node_type` response property for the response status `400` - removed the `img` enum value from the `ui/nodes/items/attributes/oneOf[subschema #2: TextAttributes represents the attributes of a text node.]/node_type` response property for the response status `200` - removed the `img` enum value from the `ui/nodes/items/attributes/oneOf[subschema #2: TextAttributes represents the attributes of a text node.]/node_type` response property for the response status `400` - removed the `img` enum value from the `ui/nodes/items/attributes/oneOf[subschema #4: AnchorAttributes represents the attributes of an anchor node.]/node_type` response property for the response status `200` - removed the `img` enum value from the `ui/nodes/items/attributes/oneOf[subschema #4: AnchorAttributes represents the attributes of an anchor node.]/node_type` response property for the response status `400` - removed the `img` enum value from the `ui/nodes/items/attributes/oneOf[subschema #5: ScriptAttributes represent script nodes which load javascript.]/node_type` response property for the response status `200` - removed the `img` enum value from the `ui/nodes/items/attributes/oneOf[subschema #5: ScriptAttributes represent script nodes which load javascript.]/node_type` response property for the response status `400` - removed the `input` enum value from the `ui/nodes/items/attributes/oneOf[subschema #2: TextAttributes represents the attributes of a text node.]/node_type` response property for the response status `200` - removed the `input` enum value from the `ui/nodes/items/attributes/oneOf[subschema #2: TextAttributes represents the attributes of a text node.]/node_type` response property for the response status `400` - removed the `input` enum value from the `ui/nodes/items/attributes/oneOf[subschema #3: ImageAttributes represents the attributes of an image node.]/node_type` response property for the response status `200` - removed the `input` enum value from the `ui/nodes/items/attributes/oneOf[subschema #3: ImageAttributes represents the attributes of an image node.]/node_type` response property for the response status `400` - removed the `input` enum value from the `ui/nodes/items/attributes/oneOf[subschema #4: AnchorAttributes represents the attributes of an anchor node.]/node_type` response property for the response status `200` - removed the `input` enum value from the `ui/nodes/items/attributes/oneOf[subschema #4: AnchorAttributes represents the attributes of an anchor node.]/node_type` response property for the response status `400` - removed the `input` enum value from the `ui/nodes/items/attributes/oneOf[subschema #5: ScriptAttributes represent script nodes which load javascript.]/node_type` response property for the response status `200` - removed the `input` enum value from the `ui/nodes/items/attributes/oneOf[subschema #5: ScriptAttributes represent script nodes which load javascript.]/node_type` response property for the response status `400` - …16 more - **2025-02-25** `df2fe8db7397` — 4 breaking, 6 warning, 10 info - added `#/components/schemas/continueWithRedirectBrowserTo` to the `continue_with/items/` response property `oneOf` list for the response status `200` - added `#/components/schemas/continueWithRedirectBrowserTo` to the `continue_with/items/` response property `oneOf` list for the response status `400` - the `continue_with/items/` response's property type/format changed from ``/`` to `object`/`` for status `200` - the `continue_with/items/` response's property type/format changed from ``/`` to `object`/`` for status `400` - added the new `captcha` enum value to the `ui/nodes/items/group` response property for the response status `200` - added the new `captcha` enum value to the `ui/nodes/items/group` response property for the response status `400` - added the new `identifier_first` enum value to the `ui/nodes/items/group` response property for the response status `200` - added the new `identifier_first` enum value to the `ui/nodes/items/group` response property for the response status `400` - added the new `saml` enum value to the `ui/nodes/items/group` response property for the response status `200` - added the new `saml` enum value to the `ui/nodes/items/group` response property for the response status `400` - added the optional property `continue_with/items/oneOf[#/components/schemas/continueWithSettingsUi]/flow/url` to the response with the `200` status - added the optional property `continue_with/items/oneOf[#/components/schemas/continueWithSettingsUi]/flow/url` to the response with the `400` status - added the optional property `ui/nodes/items/attributes/oneOf[#/components/schemas/uiNodeInputAttributes]/maxlength` to the response with the `200` status - added the optional property `ui/nodes/items/attributes/oneOf[#/components/schemas/uiNodeInputAttributes]/maxlength` to the response with the `400` status - added the optional property `ui/nodes/items/attributes/oneOf[#/components/schemas/uiNodeInputAttributes]/onclickTrigger` to the response with the `200` status - added the optional property `ui/nodes/items/attributes/oneOf[#/components/schemas/uiNodeInputAttributes]/onclickTrigger` to the response with the `400` status - added the optional property `ui/nodes/items/attributes/oneOf[#/components/schemas/uiNodeInputAttributes]/onloadTrigger` to the response with the `200` status - added the optional property `ui/nodes/items/attributes/oneOf[#/components/schemas/uiNodeInputAttributes]/onloadTrigger` to the response with the `400` status - added `redirect_browser_to` discriminator mapping keys to the `continue_with/items/` response property for the response status `200` - added `redirect_browser_to` discriminator mapping keys to the `continue_with/items/` response property for the response status `400` - **2024-06-05** `344e70f3542d` — 52 warning, 8 info - added the new `a` enum value to the `ui/nodes/items/attributes/oneOf[#/components/schemas/uiNodeInputAttributes]/node_type` response property for the response status `200` - added the new `a` enum value to the `ui/nodes/items/attributes/oneOf[#/components/schemas/uiNodeInputAttributes]/node_type` response property for the response status `400` - added the new `a` enum value to the `ui/nodes/items/attributes/oneOf[subschema #2: TextAttributes represents the attributes of a text node.]/node_type` response property for the response status `200` - added the new `a` enum value to the `ui/nodes/items/attributes/oneOf[subschema #2: TextAttributes represents the attributes of a text node.]/node_type` response property for the response status `400` - added the new `a` enum value to the `ui/nodes/items/attributes/oneOf[subschema #3: ImageAttributes represents the attributes of an image node.]/node_type` response property for the response status `200` - added the new `a` enum value to the `ui/nodes/items/attributes/oneOf[subschema #3: ImageAttributes represents the attributes of an image node.]/node_type` response property for the response status `400` - added the new `a` enum value to the `ui/nodes/items/attributes/oneOf[subschema #4: AnchorAttributes represents the attributes of an anchor node.]/node_type` response property for the response status `200` - added the new `a` enum value to the `ui/nodes/items/attributes/oneOf[subschema #4: AnchorAttributes represents the attributes of an anchor node.]/node_type` response property for the response status `400` - added the new `a` enum value to the `ui/nodes/items/attributes/oneOf[subschema #5: ScriptAttributes represent script nodes which load javascript.]/node_type` response property for the response status `200` - added the new `a` enum value to the `ui/nodes/items/attributes/oneOf[subschema #5: ScriptAttributes represent script nodes which load javascript.]/node_type` response property for the response status `400` - added the new `img` enum value to the `ui/nodes/items/attributes/oneOf[#/components/schemas/uiNodeInputAttributes]/node_type` response property for the response status `200` - added the new `img` enum value to the `ui/nodes/items/attributes/oneOf[#/components/schemas/uiNodeInputAttributes]/node_type` response property for the response status `400` - added the new `img` enum value to the `ui/nodes/items/attributes/oneOf[subschema #2: TextAttributes represents the attributes of a text node.]/node_type` response property for the response status `200` - added the new `img` enum value to the `ui/nodes/items/attributes/oneOf[subschema #2: TextAttributes represents the attributes of a text node.]/node_type` response property for the response status `400` - added the new `img` enum value to the `ui/nodes/items/attributes/oneOf[subschema #3: ImageAttributes represents the attributes of an image node.]/node_type` response property for the response status `200` - added the new `img` enum value to the `ui/nodes/items/attributes/oneOf[subschema #3: ImageAttributes represents the attributes of an image node.]/node_type` response property for the response status `400` - added the new `img` enum value to the `ui/nodes/items/attributes/oneOf[subschema #4: AnchorAttributes represents the attributes of an anchor node.]/node_type` response property for the response status `200` - added the new `img` enum value to the `ui/nodes/items/attributes/oneOf[subschema #4: AnchorAttributes represents the attributes of an anchor node.]/node_type` response property for the response status `400` - added the new `img` enum value to the `ui/nodes/items/attributes/oneOf[subschema #5: ScriptAttributes represent script nodes which load javascript.]/node_type` response property for the response status `200` - added the new `img` enum value to the `ui/nodes/items/attributes/oneOf[subschema #5: ScriptAttributes represent script nodes which load javascript.]/node_type` response property for the response status `400` - added the new `input` enum value to the `ui/nodes/items/attributes/oneOf[#/components/schemas/uiNodeInputAttributes]/node_type` response property for the response status `200` - added the new `input` enum value to the `ui/nodes/items/attributes/oneOf[#/components/schemas/uiNodeInputAttributes]/node_type` response property for the response status `400` - added the new `input` enum value to the `ui/nodes/items/attributes/oneOf[subschema #2: TextAttributes represents the attributes of a text node.]/node_type` response property for the response status `200` - added the new `input` enum value to the `ui/nodes/items/attributes/oneOf[subschema #2: TextAttributes represents the attributes of a text node.]/node_type` response property for the response status `400` - added the new `input` enum value to the `ui/nodes/items/attributes/oneOf[subschema #3: ImageAttributes represents the attributes of an image node.]/node_type` response property for the response status `200` - added the new `input` enum value to the `ui/nodes/items/attributes/oneOf[subschema #3: ImageAttributes represents the attributes of an image node.]/node_type` response property for the response status `400` - added the new `input` enum value to the `ui/nodes/items/attributes/oneOf[subschema #4: AnchorAttributes represents the attributes of an anchor node.]/node_type` response property for the response status `200` - added the new `input` enum value to the `ui/nodes/items/attributes/oneOf[subschema #4: AnchorAttributes represents the attributes of an anchor node.]/node_type` response property for the response status `400` - added the new `input` enum value to the `ui/nodes/items/attributes/oneOf[subschema #5: ScriptAttributes represent script nodes which load javascript.]/node_type` response property for the response status `200` - added the new `input` enum value to the `ui/nodes/items/attributes/oneOf[subschema #5: ScriptAttributes represent script nodes which load javascript.]/node_type` response property for the response status `400` - added the new `passkey` enum value to the `ui/nodes/items/group` response property for the response status `200` - added the new `passkey` enum value to the `ui/nodes/items/group` response property for the response status `400` - added the new `script` enum value to the `ui/nodes/items/attributes/oneOf[#/components/schemas/uiNodeInputAttributes]/node_type` response property for the response status `200` - added the new `script` enum value to the `ui/nodes/items/attributes/oneOf[#/components/schemas/uiNodeInputAttributes]/node_type` response property for the response status `400` - added the new `script` enum value to the `ui/nodes/items/attributes/oneOf[subschema #2: TextAttributes represents the attributes of a text node.]/node_type` response property for the response status `200` - added the new `script` enum value to the `ui/nodes/items/attributes/oneOf[subschema #2: TextAttributes represents the attributes of a text node.]/node_type` response property for the response status `400` - added the new `script` enum value to the `ui/nodes/items/attributes/oneOf[subschema #3: ImageAttributes represents the attributes of an image node.]/node_type` response property for the response status `200` - added the new `script` enum value to the `ui/nodes/items/attributes/oneOf[subschema #3: ImageAttributes represents the attributes of an image node.]/node_type` response property for the response status `400` - added the new `script` enum value to the `ui/nodes/items/attributes/oneOf[subschema #4: AnchorAttributes represents the attributes of an anchor node.]/node_type` response property for the response status `200` - added the new `script` enum value to the `ui/nodes/items/attributes/oneOf[subschema #4: AnchorAttributes represents the attributes of an anchor node.]/node_type` response property for the response status `400` - …20 more - **2024-02-20** `4f071812f3ea` — 2 breaking, 8 info - the `state` response's property type/format changed from `string`/`` to ``/`` for status `200` - the `state` response's property type/format changed from `string`/`` to ``/`` for status `400` - added the optional property `continue_with` to the response with the `200` status - added the optional property `continue_with` to the response with the `400` status - removed the `choose_method` enum value from the `state` response property for the response status `200` - removed the `choose_method` enum value from the `state` response property for the response status `400` - removed the `passed_challenge` enum value from the `state` response property for the response status `200` - removed the `passed_challenge` enum value from the `state` response property for the response status `400` - removed the `sent_email` enum value from the `state` response property for the response status `200` - removed the `sent_email` enum value from the `state` response property for the response status `400` - **2023-04-29** `2e602390c3aa` — 5 breaking, 7 warning, 9 info - request property `oneOf[#/components/schemas/updateRecoveryFlowWithCodeMethod]/method` was restricted to a list of enum values (media type: application/json) - request property `oneOf[#/components/schemas/updateRecoveryFlowWithCodeMethod]/method` was restricted to a list of enum values (media type: application/x-www-form-urlencoded) - request property `oneOf[#/components/schemas/updateRecoveryFlowWithLinkMethod]/method` was restricted to a list of enum values (media type: application/json) - request property `oneOf[#/components/schemas/updateRecoveryFlowWithLinkMethod]/method` was restricted to a list of enum values (media type: application/x-www-form-urlencoded) - removed the required property `message` from the response with the `422` status - removed the optional property `code` from the response with the `422` status - removed the optional property `debug` from the response with the `422` status - removed the optional property `details` from the response with the `422` status - removed the optional property `id` from the response with the `422` status - removed the optional property `reason` from the response with the `422` status - removed the optional property `request` from the response with the `422` status - removed the optional property `status` from the response with the `422` status - added the new `code` enum value to the request property `oneOf[#/components/schemas/updateRecoveryFlowWithCodeMethod]/method` (media type: application/json) - added the new `code` enum value to the request property `oneOf[#/components/schemas/updateRecoveryFlowWithCodeMethod]/method` (media type: application/x-www-form-urlencoded) - added the new `code` enum value to the request property `oneOf[#/components/schemas/updateRecoveryFlowWithLinkMethod]/method` (media type: application/json) - added the new `code` enum value to the request property `oneOf[#/components/schemas/updateRecoveryFlowWithLinkMethod]/method` (media type: application/x-www-form-urlencoded) - added the new `link` enum value to the request property `oneOf[#/components/schemas/updateRecoveryFlowWithCodeMethod]/method` (media type: application/json) - added the new `link` enum value to the request property `oneOf[#/components/schemas/updateRecoveryFlowWithCodeMethod]/method` (media type: application/x-www-form-urlencoded) - added the new `link` enum value to the request property `oneOf[#/components/schemas/updateRecoveryFlowWithLinkMethod]/method` (media type: application/json) - added the new `link` enum value to the request property `oneOf[#/components/schemas/updateRecoveryFlowWithLinkMethod]/method` (media type: application/x-www-form-urlencoded) - added the optional property `error` to the response with the `422` status - **2022-12-02** `b6e5ffa30d4c` — 4 breaking, 62 warning, 13 info - removed `#/components/schemas/submitSelfServiceRecoveryFlowWithLinkMethodBody` from the request body `oneOf` list (media type: application/json) - removed `#/components/schemas/submitSelfServiceRecoveryFlowWithLinkMethodBody` from the request body `oneOf` list (media type: application/x-www-form-urlencoded) - the `id` response's property type/format changed from `string`/`uuid4` to `string`/`uuid` for status `200` - the `id` response's property type/format changed from `string`/`uuid4` to `string`/`uuid` for status `400` - added the new `button` enum value to the `ui/nodes/items/attributes/oneOf[#/components/schemas/uiNodeInputAttributes]/type` response property for the response status `200` - added the new `button` enum value to the `ui/nodes/items/attributes/oneOf[#/components/schemas/uiNodeInputAttributes]/type` response property for the response status `400` - added the new `checkbox` enum value to the `ui/nodes/items/attributes/oneOf[#/components/schemas/uiNodeInputAttributes]/type` response property for the response status `200` - added the new `checkbox` enum value to the `ui/nodes/items/attributes/oneOf[#/components/schemas/uiNodeInputAttributes]/type` response property for the response status `400` - added the new `code` enum value to the `ui/nodes/items/group` response property for the response status `200` - added the new `code` enum value to the `ui/nodes/items/group` response property for the response status `400` - added the new `date` enum value to the `ui/nodes/items/attributes/oneOf[#/components/schemas/uiNodeInputAttributes]/type` response property for the response status `200` - added the new `date` enum value to the `ui/nodes/items/attributes/oneOf[#/components/schemas/uiNodeInputAttributes]/type` response property for the response status `400` - added the new `datetime-local` enum value to the `ui/nodes/items/attributes/oneOf[#/components/schemas/uiNodeInputAttributes]/type` response property for the response status `200` - added the new `datetime-local` enum value to the `ui/nodes/items/attributes/oneOf[#/components/schemas/uiNodeInputAttributes]/type` response property for the response status `400` - added the new `email` enum value to the `ui/nodes/items/attributes/oneOf[#/components/schemas/uiNodeInputAttributes]/type` response property for the response status `200` - added the new `email` enum value to the `ui/nodes/items/attributes/oneOf[#/components/schemas/uiNodeInputAttributes]/type` response property for the response status `400` - added the new `error` enum value to the `ui/messages/items/type` response property for the response status `200` - added the new `error` enum value to the `ui/messages/items/type` response property for the response status `400` - added the new `error` enum value to the `ui/nodes/items/attributes/oneOf[#/components/schemas/uiNodeInputAttributes]/label/type` response property for the response status `200` - added the new `error` enum value to the `ui/nodes/items/attributes/oneOf[#/components/schemas/uiNodeInputAttributes]/label/type` response property for the response status `400` - added the new `error` enum value to the `ui/nodes/items/attributes/oneOf[subschema #2: TextAttributes represents the attributes of a text node.]/text/type` response property for the response status `200` - added the new `error` enum value to the `ui/nodes/items/attributes/oneOf[subschema #2: TextAttributes represents the attributes of a text node.]/text/type` response property for the response status `400` - added the new `error` enum value to the `ui/nodes/items/attributes/oneOf[subschema #4: AnchorAttributes represents the attributes of an anchor node.]/title/type` response property for the response status `200` - added the new `error` enum value to the `ui/nodes/items/attributes/oneOf[subschema #4: AnchorAttributes represents the attributes of an anchor node.]/title/type` response property for the response status `400` - added the new `error` enum value to the `ui/nodes/items/messages/items/type` response property for the response status `200` - added the new `error` enum value to the `ui/nodes/items/messages/items/type` response property for the response status `400` - added the new `error` enum value to the `ui/nodes/items/meta/label/type` response property for the response status `200` - added the new `error` enum value to the `ui/nodes/items/meta/label/type` response property for the response status `400` - added the new `hidden` enum value to the `ui/nodes/items/attributes/oneOf[#/components/schemas/uiNodeInputAttributes]/type` response property for the response status `200` - added the new `hidden` enum value to the `ui/nodes/items/attributes/oneOf[#/components/schemas/uiNodeInputAttributes]/type` response property for the response status `400` - added the new `info` enum value to the `ui/messages/items/type` response property for the response status `200` - added the new `info` enum value to the `ui/messages/items/type` response property for the response status `400` - added the new `info` enum value to the `ui/nodes/items/attributes/oneOf[#/components/schemas/uiNodeInputAttributes]/label/type` response property for the response status `200` - added the new `info` enum value to the `ui/nodes/items/attributes/oneOf[#/components/schemas/uiNodeInputAttributes]/label/type` response property for the response status `400` - added the new `info` enum value to the `ui/nodes/items/attributes/oneOf[subschema #2: TextAttributes represents the attributes of a text node.]/text/type` response property for the response status `200` - added the new `info` enum value to the `ui/nodes/items/attributes/oneOf[subschema #2: TextAttributes represents the attributes of a text node.]/text/type` response property for the response status `400` - added the new `info` enum value to the `ui/nodes/items/attributes/oneOf[subschema #4: AnchorAttributes represents the attributes of an anchor node.]/title/type` response property for the response status `200` - added the new `info` enum value to the `ui/nodes/items/attributes/oneOf[subschema #4: AnchorAttributes represents the attributes of an anchor node.]/title/type` response property for the response status `400` - added the new `info` enum value to the `ui/nodes/items/messages/items/type` response property for the response status `200` - added the new `info` enum value to the `ui/nodes/items/messages/items/type` response property for the response status `400` - …39 more - **2022-06-01** `fca041c7721f` — 1 breaking, 26 warning, 7 info - request body became required - added the new `a` enum value to the `ui/nodes/items/type` response property for the response status `200` - added the new `a` enum value to the `ui/nodes/items/type` response property for the response status `400` - added the new `default` enum value to the `ui/nodes/items/group` response property for the response status `200` - added the new `default` enum value to the `ui/nodes/items/group` response property for the response status `400` - added the new `img` enum value to the `ui/nodes/items/type` response property for the response status `200` - added the new `img` enum value to the `ui/nodes/items/type` response property for the response status `400` - added the new `input` enum value to the `ui/nodes/items/type` response property for the response status `200` - added the new `input` enum value to the `ui/nodes/items/type` response property for the response status `400` - added the new `link` enum value to the `ui/nodes/items/group` response property for the response status `200` - added the new `link` enum value to the `ui/nodes/items/group` response property for the response status `400` - added the new `lookup_secret` enum value to the `ui/nodes/items/group` response property for the response status `200` - added the new `lookup_secret` enum value to the `ui/nodes/items/group` response property for the response status `400` - added the new `oidc` enum value to the `ui/nodes/items/group` response property for the response status `200` - added the new `oidc` enum value to the `ui/nodes/items/group` response property for the response status `400` - added the new `password` enum value to the `ui/nodes/items/group` response property for the response status `200` - added the new `password` enum value to the `ui/nodes/items/group` response property for the response status `400` - added the new `profile` enum value to the `ui/nodes/items/group` response property for the response status `200` - added the new `profile` enum value to the `ui/nodes/items/group` response property for the response status `400` - added the new `script` enum value to the `ui/nodes/items/type` response property for the response status `200` - added the new `script` enum value to the `ui/nodes/items/type` response property for the response status `400` - added the new `text` enum value to the `ui/nodes/items/type` response property for the response status `200` - added the new `text` enum value to the `ui/nodes/items/type` response property for the response status `400` - added the new `totp` enum value to the `ui/nodes/items/group` response property for the response status `200` - added the new `totp` enum value to the `ui/nodes/items/group` response property for the response status `400` - added the new `webauthn` enum value to the `ui/nodes/items/group` response property for the response status `200` - added the new `webauthn` enum value to the `ui/nodes/items/group` response property for the response status `400` - added the new optional `header` request parameter `Cookie` - the response property `type` became required for the status `200` - the response property `type` became required for the status `400` - added `a, img` discriminator mapping keys to the `ui/nodes/items/attributes` response property for the response status `200` - added `a, img` discriminator mapping keys to the `ui/nodes/items/attributes` response property for the response status `400` - removed `anchor, image` discriminator mapping keys from the `ui/nodes/items/attributes` response property for the response status `200` - removed `anchor, image` discriminator mapping keys from the `ui/nodes/items/attributes` response property for the response status `400` - **2022-03-25** `7402181057bd` — 1 info - added the non-success response with the status `410` - **2022-03-22** `028a4cf83c15` — 8 info - added the non-success response with the status `303` - removed the non-success response with the status `302` - the response property `ui/nodes/items/attributes/oneOf[subschema #3: ImageAttributes represents the attributes of an image node.]/height` became required for the status `200` - the response property `ui/nodes/items/attributes/oneOf[subschema #3: ImageAttributes represents the attributes of an image node.]/height` became required for the status `400` - the response property `ui/nodes/items/attributes/oneOf[subschema #3: ImageAttributes represents the attributes of an image node.]/width` became required for the status `200` - the response property `ui/nodes/items/attributes/oneOf[subschema #3: ImageAttributes represents the attributes of an image node.]/width` became required for the status `400` - added the required property `ui/nodes/items/attributes/oneOf[subschema #5: ScriptAttributes represent script nodes which load javascript.]/nonce` to the response with the `200` status - added the required property `ui/nodes/items/attributes/oneOf[subschema #5: ScriptAttributes represent script nodes which load javascript.]/nonce` to the response with the `400` status - **2021-10-28** `c55ed8ad9f0c` — 2 breaking, 27 info - added `#/components/schemas/uiNodeScriptAttributes` to the `ui/nodes/items/attributes` response property `oneOf` list for the response status `200` - added `#/components/schemas/uiNodeScriptAttributes` to the `ui/nodes/items/attributes` response property `oneOf` list for the response status `400` - api tag `v0alpha2` added - api tag `v0alpha1` removed - added the optional property `error/id` to the response with the `500` status - added the optional property `return_to` to the response with the `200` status - added the optional property `return_to` to the response with the `400` status - added the optional property `ui/nodes/items/attributes/oneOf[#/components/schemas/uiNodeInputAttributes]/onclick` to the response with the `200` status - added the optional property `ui/nodes/items/attributes/oneOf[#/components/schemas/uiNodeInputAttributes]/onclick` to the response with the `400` status - added the optional property `ui/nodes/items/attributes/oneOf[subschema #3: ImageAttributes represents the attributes of an image node.]/height` to the response with the `200` status - added the optional property `ui/nodes/items/attributes/oneOf[subschema #3: ImageAttributes represents the attributes of an image node.]/height` to the response with the `400` status - added the optional property `ui/nodes/items/attributes/oneOf[subschema #3: ImageAttributes represents the attributes of an image node.]/width` to the response with the `200` status - added the optional property `ui/nodes/items/attributes/oneOf[subschema #3: ImageAttributes represents the attributes of an image node.]/width` to the response with the `400` status - added discriminator to `ui/nodes/items/attributes` response property for the response status `200` - added discriminator to `ui/nodes/items/attributes` response property for the response status `400` - added the required property `ui/nodes/items/attributes/oneOf[#/components/schemas/uiNodeInputAttributes]/node_type` to the response with the `200` status - added the required property `ui/nodes/items/attributes/oneOf[#/components/schemas/uiNodeInputAttributes]/node_type` to the response with the `400` status - added the required property `ui/nodes/items/attributes/oneOf[subschema #2: TextAttributes represents the attributes of a text node.]/id` to the response with the `200` status - added the required property `ui/nodes/items/attributes/oneOf[subschema #2: TextAttributes represents the attributes of a text node.]/id` to the response with the `400` status - added the required property `ui/nodes/items/attributes/oneOf[subschema #2: TextAttributes represents the attributes of a text node.]/node_type` to the response with the `200` status - added the required property `ui/nodes/items/attributes/oneOf[subschema #2: TextAttributes represents the attributes of a text node.]/node_type` to the response with the `400` status - added the required property `ui/nodes/items/attributes/oneOf[subschema #3: ImageAttributes represents the attributes of an image node.]/id` to the response with the `200` status - added the required property `ui/nodes/items/attributes/oneOf[subschema #3: ImageAttributes represents the attributes of an image node.]/id` to the response with the `400` status - added the required property `ui/nodes/items/attributes/oneOf[subschema #3: ImageAttributes represents the attributes of an image node.]/node_type` to the response with the `200` status - added the required property `ui/nodes/items/attributes/oneOf[subschema #3: ImageAttributes represents the attributes of an image node.]/node_type` to the response with the `400` status - added the required property `ui/nodes/items/attributes/oneOf[subschema #4: AnchorAttributes represents the attributes of an anchor node.]/id` to the response with the `200` status - added the required property `ui/nodes/items/attributes/oneOf[subschema #4: AnchorAttributes represents the attributes of an anchor node.]/id` to the response with the `400` status - added the required property `ui/nodes/items/attributes/oneOf[subschema #4: AnchorAttributes represents the attributes of an anchor node.]/node_type` to the response with the `200` status - added the required property `ui/nodes/items/attributes/oneOf[subschema #4: AnchorAttributes represents the attributes of an anchor node.]/node_type` to the response with the `400` status - **2021-09-12** `990ebe0a8820` — 2 breaking - removed the enum value `link` of the request property `oneOf[#/components/schemas/submitSelfServiceRecoveryFlowWithLinkMethodBody]/method` (media type: application/json) - removed the enum value `link` of the request property `oneOf[#/components/schemas/submitSelfServiceRecoveryFlowWithLinkMethodBody]/method` (media type: application/x-www-form-urlencoded) - **2021-07-22** `071bec03ddcd` — 4 breaking, 2 info - removed the enum value `oidc` of the request property `oneOf[#/components/schemas/submitSelfServiceRecoveryFlowWithLinkMethodBody]/method` (media type: application/json) - removed the enum value `oidc` of the request property `oneOf[#/components/schemas/submitSelfServiceRecoveryFlowWithLinkMethodBody]/method` (media type: application/x-www-form-urlencoded) - removed the enum value `password` of the request property `oneOf[#/components/schemas/submitSelfServiceRecoveryFlowWithLinkMethodBody]/method` (media type: application/json) - removed the enum value `password` of the request property `oneOf[#/components/schemas/submitSelfServiceRecoveryFlowWithLinkMethodBody]/method` (media type: application/x-www-form-urlencoded) - added the new `link` enum value to the request property `oneOf[#/components/schemas/submitSelfServiceRecoveryFlowWithLinkMethodBody]/method` (media type: application/json) - added the new `link` enum value to the request property `oneOf[#/components/schemas/submitSelfServiceRecoveryFlowWithLinkMethodBody]/method` (media type: application/x-www-form-urlencoded) - **2021-07-13** `8f1b399ab6e6` — 2 breaking, 3 warning, 10 info - the request's body type/format changed from `object`/`` to ``/`` (media type: application/json) - the response property `ui/nodes/items/attributes/oneOf[#/components/schemas/uiNodeInputAttributes]/value` became nullable for the status `400` - added the new `choose_method` enum value to the `state` response property for the response status `400` - added the new `passed_challenge` enum value to the `state` response property for the response status `400` - added the new `sent_email` enum value to the `state` response property for the response status `400` - api tag `v0alpha1` added - api tag `public` removed - added the new optional `query` request parameter `token` - added request discriminator (media type: application/json) - added request discriminator (media type: application/x-www-form-urlencoded) - added `#/components/schemas/submitSelfServiceRecoveryFlowWithLinkMethodBody` to the request body `oneOf` list (media type: application/json) - added `#/components/schemas/submitSelfServiceRecoveryFlowWithLinkMethodBody` to the request body `oneOf` list (media type: application/x-www-form-urlencoded) - the request's body type/format was generalized from `object`/`` to ``/`` (media type: application/x-www-form-urlencoded) - removed `subschema #1, subschema #2, subschema #3` from the `ui/nodes/items/attributes/oneOf[#/components/schemas/uiNodeInputAttributes]/value` response property `oneOf` list for the response status `400` - added the success response with the status `200` - **2021-05-18** `9123bcead5ed` — 2 info - the response property `error` became required for the status `500` - the response property `error/message` became required for the status `500` - **2021-05-05** `381c760af46e` — 18 breaking, 11 warning, 62 info - removed `#/components/schemas/updateRecoveryFlowWithLinkMethod, #/components/schemas/updateRecoveryFlowWithCodeMethod` from the request body `oneOf` list (media type: application/json) - removed `#/components/schemas/updateRecoveryFlowWithLinkMethod, #/components/schemas/updateRecoveryFlowWithCodeMethod` from the request body `oneOf` list (media type: application/x-www-form-urlencoded) - the request's body type/format changed from ``/`` to `object`/`` (media type: application/json) - the request's body type/format changed from ``/`` to `object`/`` (media type: application/x-www-form-urlencoded) - the response property `type` became optional for the status `400` - added `subschema #1, subschema #2, subschema #3` to the `ui/nodes/items/attributes/oneOf[#/components/schemas/uiNodeInputAttributes]/value` response property `oneOf` list for the response status `400` - the `id` response's property type/format changed from `string`/`uuid` to `string`/`uuid4` for status `400` - the `state` response's property type/format changed from ``/`` to `string`/`` for status `400` - removed the required property `ui/nodes/items/attributes/oneOf[#/components/schemas/uiNodeInputAttributes]/node_type` from the response with the `400` status - removed the required property `ui/nodes/items/attributes/oneOf[subschema #2: TextAttributes represents the attributes of a text node.]/id` from the response with the `400` status - removed the required property `ui/nodes/items/attributes/oneOf[subschema #2: TextAttributes represents the attributes of a text node.]/node_type` from the response with the `400` status - removed the required property `ui/nodes/items/attributes/oneOf[subschema #3: ImageAttributes represents the attributes of an image node.]/height` from the response with the `400` status - removed the required property `ui/nodes/items/attributes/oneOf[subschema #3: ImageAttributes represents the attributes of an image node.]/id` from the response with the `400` status - removed the required property `ui/nodes/items/attributes/oneOf[subschema #3: ImageAttributes represents the attributes of an image node.]/node_type` from the response with the `400` status - removed the required property `ui/nodes/items/attributes/oneOf[subschema #3: ImageAttributes represents the attributes of an image node.]/width` from the response with the `400` status - removed the required property `ui/nodes/items/attributes/oneOf[subschema #4: AnchorAttributes represents the attributes of an anchor node.]/id` from the response with the `400` status - removed the required property `ui/nodes/items/attributes/oneOf[subschema #4: AnchorAttributes represents the attributes of an anchor node.]/node_type` from the response with the `400` status - removed the success response with the status `200` - deleted the `header` request parameter `Cookie` - deleted the `query` request parameter `token` - removed the optional property `continue_with` from the response with the `400` status - removed the optional property `return_to` from the response with the `400` status - removed the optional property `transient_payload` from the response with the `400` status - removed the optional property `ui/nodes/items/attributes/oneOf[#/components/schemas/uiNodeInputAttributes]/autocomplete` from the response with the `400` status - removed the optional property `ui/nodes/items/attributes/oneOf[#/components/schemas/uiNodeInputAttributes]/maxlength` from the response with the `400` status - removed the optional property `ui/nodes/items/attributes/oneOf[#/components/schemas/uiNodeInputAttributes]/onclick` from the response with the `400` status - removed the optional property `ui/nodes/items/attributes/oneOf[#/components/schemas/uiNodeInputAttributes]/onclickTrigger` from the response with the `400` status - removed the optional property `ui/nodes/items/attributes/oneOf[#/components/schemas/uiNodeInputAttributes]/onload` from the response with the `400` status - removed the optional property `ui/nodes/items/attributes/oneOf[#/components/schemas/uiNodeInputAttributes]/onloadTrigger` from the response with the `400` status - api operation id `updateRecoveryFlow` removed and replaced with `submitSelfServiceRecoveryFlow` - api tag `public` added - api tag `frontend` removed - request body became optional - removed request discriminator (media type: application/json) - removed request discriminator (media type: application/x-www-form-urlencoded) - added the non-success response with the status `302` - added the non-success response with the status `500` - removed the non-success response with the status `303` - removed the non-success response with the status `410` - removed the non-success response with the status `422` - …51 more --- [Operation](https://skmtc.dev/ory/apis/ory-identities-api/docs/self-service/recovery/post.md) · [API](https://skmtc.dev/ory/apis/ory-identities-api.md) · [Page](https://skmtc.dev/ory/apis/ory-identities-api/changes/self-service/recovery/post)