--- title: "Changes to Create Recovery Flow for Browsers" method: GET path: "/self-service/recovery/browser" --- # Changes to Create Recovery Flow for Browsers `GET /self-service/recovery/browser` > Every recorded change to this endpoint, newest first. ## Timeline Changed in 11 of 47 revisions. - **2025-11-07** `5f08e5827b5e` — 1 breaking, 2 warning, 21 info - **2025-02-25** `df2fe8db7397` — 2 breaking, 3 warning, 5 info - **2024-06-05** `344e70f3542d` — 26 warning, 2 info - **2024-02-20** `4f071812f3ea` — 1 breaking, 4 info - **2022-12-02** `b6e5ffa30d4c` — 1 breaking, 31 warning, 5 info - **2022-06-01** `fca041c7721f` — 13 warning, 3 info - **2022-03-22** `028a4cf83c15` — 5 info - **2021-10-28** `c55ed8ad9f0c` — 1 breaking, 17 info - **2021-07-13** `8f1b399ab6e6` — 5 info - **2021-05-18** `9123bcead5ed` — 3 info - **2021-05-05** `381c760af46e` — 1 breaking, 1 warning, 7 info ## Changes - **2025-11-07** `5f08e5827b5e` — 1 breaking, 2 warning, 21 info - added `#/components/schemas/uiNodeDivisionAttributes` to the `ui/nodes/items/attributes` response property `oneOf` list for the response status `200` - added the new `div` enum value to the `ui/nodes/items/type` 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 `200` - added `div` discriminator mapping keys to the `ui/nodes/items/attributes` 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 `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 `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 `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 `200` - 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[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 #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 #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 #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 #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 #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 #5: ScriptAttributes represent script nodes which load javascript.]/node_type` response property for the response status `200` - removed the `script` enum value from the `ui/nodes/items/attributes/oneOf[#/components/schemas/uiNodeInputAttributes]/node_type` response property for the response status `200` - removed the `script` 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 `script` 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 `script` 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 `text` enum value from the `ui/nodes/items/attributes/oneOf[#/components/schemas/uiNodeInputAttributes]/node_type` response property for the response status `200` - removed the `text` 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 `text` 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 `text` 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` - **2025-02-25** `df2fe8db7397` — 2 breaking, 3 warning, 5 info - added `#/components/schemas/continueWithRedirectBrowserTo` to the `continue_with/items/` response property `oneOf` list for the response status `200` - the `continue_with/items/` response's property type/format changed from ``/`` to `object`/`` for status `200` - added the new `captcha` 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 `200` - added the new `saml` enum value to the `ui/nodes/items/group` response property for the response status `200` - added the optional property `continue_with/items/oneOf[#/components/schemas/continueWithSettingsUi]/flow/url` 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 `200` 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]/onloadTrigger` to the response with the `200` status - added `redirect_browser_to` discriminator mapping keys to the `continue_with/items/` response property for the response status `200` - **2024-06-05** `344e70f3542d` — 26 warning, 2 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[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 #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 #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 #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[#/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[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 #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 #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 #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[#/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[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 #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 #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 #5: ScriptAttributes represent script nodes which load javascript.]/node_type` 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 `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 `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 `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 `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 `200` - added the new `script` 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 `text` enum value to the `ui/nodes/items/attributes/oneOf[#/components/schemas/uiNodeInputAttributes]/node_type` response property for the response status `200` - added the new `text` 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 `text` 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 `text` 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 `text` 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 optional property `transient_payload` to the response with the `200` status - added the optional property `ui/nodes/items/attributes/oneOf[#/components/schemas/uiNodeInputAttributes]/onload` to the response with the `200` status - **2024-02-20** `4f071812f3ea` — 1 breaking, 4 info - the `state` response's property type/format changed from `string`/`` to ``/`` for status `200` - added the optional property `continue_with` to the response with the `200` status - removed the `choose_method` 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 `200` - removed the `sent_email` enum value from the `state` response property for the response status `200` - **2022-12-02** `b6e5ffa30d4c` — 1 breaking, 31 warning, 5 info - the `id` response's property type/format changed from `string`/`uuid4` to `string`/`uuid` for 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 `200` - 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 `code` enum value to the `ui/nodes/items/group` 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 `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 `200` - 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 `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/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[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 #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/messages/items/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 `200` - 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 `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/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[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 #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/messages/items/type` response property for the response status `200` - added the new `info` enum value to the `ui/nodes/items/meta/label/type` response property for the response status `200` - added the new `number` enum value to the `ui/nodes/items/attributes/oneOf[#/components/schemas/uiNodeInputAttributes]/type` response property for the response status `200` - added the new `password` enum value to the `ui/nodes/items/attributes/oneOf[#/components/schemas/uiNodeInputAttributes]/type` response property for the response status `200` - added the new `submit` enum value to the `ui/nodes/items/attributes/oneOf[#/components/schemas/uiNodeInputAttributes]/type` response property for the response status `200` - added the new `success` enum value to the `ui/messages/items/type` response property for the response status `200` - added the new `success` enum value to the `ui/nodes/items/attributes/oneOf[#/components/schemas/uiNodeInputAttributes]/label/type` response property for the response status `200` - added the new `success` 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 `success` 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 `success` enum value to the `ui/nodes/items/messages/items/type` response property for the response status `200` - added the new `success` enum value to the `ui/nodes/items/meta/label/type` response property for the response status `200` - added the new `tel` enum value to the `ui/nodes/items/attributes/oneOf[#/components/schemas/uiNodeInputAttributes]/type` response property for the response status `200` - added the new `text` enum value to the `ui/nodes/items/attributes/oneOf[#/components/schemas/uiNodeInputAttributes]/type` response property for the response status `200` - added the new `url` enum value to the `ui/nodes/items/attributes/oneOf[#/components/schemas/uiNodeInputAttributes]/type` response property for the response status `200` - api operation id `initializeSelfServiceRecoveryFlowForBrowsers` removed and replaced with `createBrowserRecoveryFlow` - api tag `frontend` added - api tag `v0alpha2` removed - removed the non-success response with the status `500` - added the optional property `ui/nodes/items/attributes/oneOf[#/components/schemas/uiNodeInputAttributes]/autocomplete` to the response with the `200` status - **2022-06-01** `fca041c7721f` — 13 warning, 3 info - added the new `a` enum value to the `ui/nodes/items/type` 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 `200` - added the new `img` 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 `200` - added the new `link` 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 `200` - added the new `oidc` 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 `200` - added the new `profile` enum value to the `ui/nodes/items/group` 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 `200` - added the new `text` enum value to the `ui/nodes/items/type` 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 `200` - added the new `webauthn` enum value to the `ui/nodes/items/group` response property for the response status `200` - the response property `type` became required for the status `200` - added `a, img` discriminator mapping keys to 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 `200` - **2022-03-22** `028a4cf83c15` — 5 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.]/width` became required for the status `200` - 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 - **2021-10-28** `c55ed8ad9f0c` — 1 breaking, 17 info - added `#/components/schemas/uiNodeScriptAttributes` to the `ui/nodes/items/attributes` response property `oneOf` list for the response status `200` - api tag `v0alpha2` added - api tag `v0alpha1` removed - added the new optional `query` request parameter `return_to` - added the optional property `error/id` to the response with the `400` status - 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 `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[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.]/width` to the response with the `200` status - added discriminator to `ui/nodes/items/attributes` response property for the response status `200` - 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[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.]/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.]/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.]/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.]/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.]/node_type` to the response with the `200` status - **2021-07-13** `8f1b399ab6e6` — 5 info - api operation id `initializeSelfServiceRecoveryForBrowsers` removed and replaced with `initializeSelfServiceRecoveryFlowForBrowsers` - api tag `v0alpha1` added - api tag `public` removed - added the non-success response with the status `400` - added the success response with the status `200` - **2021-05-18** `9123bcead5ed` — 3 info - api operation id `initializeSelfServiceRecoveryViaBrowserFlow` removed and replaced with `initializeSelfServiceRecoveryForBrowsers` - 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` — 1 breaking, 1 warning, 7 info - removed the success response with the status `200` - deleted the `query` request parameter `return_to` - api operation id `createBrowserRecoveryFlow` removed and replaced with `initializeSelfServiceRecoveryViaBrowserFlow` - api tag `public` added - api tag `frontend` removed - 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 `400` --- [Operation](https://skmtc.dev/ory/apis/ory-identities-api/docs/self-service/recovery/browser/get.md) · [API](https://skmtc.dev/ory/apis/ory-identities-api.md) · [Page](https://skmtc.dev/ory/apis/ory-identities-api/changes/self-service/recovery/browser/get)