---
title: "Changes to Exchange Session Token"
method: GET
path: "/sessions/token-exchange"
---

# Changes to Exchange Session Token

`GET /sessions/token-exchange`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 6 of 47 revisions.

- **2025-11-07** `5f08e5827b5e`: 1 breaking, 3 warning, 2 info
- **2025-02-25** `df2fe8db7397`: 2 breaking, 1 warning, 2 info
- **2024-06-05** `344e70f3542d`: 2 warning, 1 info
- **2024-02-20** `4f071812f3ea`: 1 breaking, 6 warning, 3 info
- **2023-08-31** `d10e7b267596`: 1 info
- **2021-05-05** `381c760af46e`: 1 breaking

## Changes

- **2025-11-07** `5f08e5827b5e`: 1 breaking, 3 warning, 2 info
  - the response property `session/identity/recovery_addresses/items/id` became optional for the status `200`
  - added the new `passkey` enum value to the `session/authentication_methods/items/method` response property for the response status `200`
  - added the new `profile` enum value to the `session/authentication_methods/items/method` response property for the response status `200`
  - added the new `saml` enum value to the `session/authentication_methods/items/method` response property for the response status `200`
  - added the optional property `session/identity/external_id` to the response with the `200` status
  - removed the `v0.6_legacy_session` enum value from the `session/authentication_methods/items/method` response property for the response status `200`
- **2025-02-25** `df2fe8db7397`: 2 breaking, 1 warning, 2 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 changed from no type to `object` for status `200`
  - added the new `saml` enum value to the `session/identity/credentials/additionalProperties/type` 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 `redirect_browser_to` discriminator mapping keys to the `continue_with/items/` response property for the response status `200`
- **2024-06-05** `344e70f3542d`: 2 warning, 1 info
  - added the new `passkey` enum value to the `session/identity/credentials/additionalProperties/type` response property for the response status `200`
  - added the new `profile` enum value to the `session/identity/credentials/additionalProperties/type` response property for the response status `200`
  - added the optional property `continue_with` to the response with the `200` status
- **2024-02-20** `4f071812f3ea`: 1 breaking, 6 warning, 3 info
  - the response property `session/identity` became optional for the status `200`
  - added the new `code` enum value to the `session/authentication_methods/items/method` response property for the response status `200`
  - added the new `code` enum value to the `session/identity/credentials/additionalProperties/type` response property for the response status `200`
  - added the new `code_recovery` enum value to the `session/identity/credentials/additionalProperties/type` response property for the response status `200`
  - added the new `email` enum value to the `session/identity/verifiable_addresses/items/via` response property for the response status `200`
  - added the new `link_recovery` enum value to the `session/identity/credentials/additionalProperties/type` response property for the response status `200`
  - added the new `sms` enum value to the `session/identity/verifiable_addresses/items/via` response property for the response status `200`
  - added the optional property `session/authentication_methods/items/organization` to the response with the `200` status
  - added the optional property `session/identity/organization_id` to the response with the `200` status
  - added the optional property `session/tokenized` to the response with the `200` status
- **2023-08-31** `d10e7b267596`: 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/sessions/token-exchange/get.md) - [API](https://skmtc.dev/ory/apis/ory-identities-api.md) - [Page](https://skmtc.dev/ory/apis/ory-identities-api/changes/sessions/token-exchange/get)
