---
title: "Changes to Authenticate"
method: POST
path: "/v1/magic_links/authenticate"
---

# Changes to Authenticate

`POST /v1/magic_links/authenticate`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 6 of 26 revisions.

- **2026-03-07** `110f26a94e5b`: 1 info
- **2026-03-06** `9cab20b8eca7`: 1 breaking
- **2026-01-09** `7dfcc14e566c`: 8 breaking, 1 info
- **2025-10-23** `4a2e3c0c0c05`: 3 breaking, 1 warning, 20 info
- **2025-09-17** `8270cf3a3d4c`: 3 info
- **2025-09-17** `864b9f438ac0`: 17 breaking

## Changes

- **2026-03-07** `110f26a94e5b`: 1 info
  - endpoint added
- **2026-03-06** `9cab20b8eca7`: 1 breaking
  - api path removed without deprecation
- **2026-01-09** `7dfcc14e566c`: 8 breaking, 1 info
  - the `session_custom_claims` request property type changed from `string` to `object`
  - the `member/roles/items/sources/items/details` response's property type changed from `string` to `object` for status `200`
  - the `member/sso_registrations/items/sso_attributes` response's property type changed from `string` to `object` for status `200`
  - the `member/trusted_metadata` response's property type changed from `string` to `object` for status `200`
  - the `member/untrusted_metadata` response's property type changed from `string` to `object` for status `200`
  - the `member_session/custom_claims` response's property type changed from `string` to `object` for status `200`
  - the `organization/allowed_oauth_tenants` response's property type changed from `string` to `object` for status `200`
  - the `organization/trusted_metadata` response's property type changed from `string` to `object` for status `200`
  - added the required property `organization/custom_roles` to the response with the `200` status
- **2025-10-23** `4a2e3c0c0c05`: 3 breaking, 1 warning, 20 info
  - added the new required request property `magic_links_token`
  - removed the required property `discovered_organizations` from the response with the `200` status
  - removed the required property `email_address` from the response with the `200` status
  - removed the request property `discovery_magic_links_token`
  - added the new optional request property `intermediate_session_token`
  - added the new optional request property `locale`
  - added the new optional request property `session_custom_claims`
  - added the new optional request property `session_duration_minutes`
  - added the new optional request property `session_jwt`
  - added the new optional request property `session_token`
  - added the new optional request property `telemetry_id`
  - added the optional property `member_device` to the response with the `200` status
  - added the optional property `member_session` to the response with the `200` status
  - added the optional property `mfa_required` to the response with the `200` status
  - added the optional property `primary_required` to the response with the `200` status
  - added the required property `member` to the response with the `200` status
  - added the required property `member_authenticated` to the response with the `200` status
  - added the required property `member_id` to the response with the `200` status
  - added the required property `method_id` to the response with the `200` status
  - added the required property `organization` to the response with the `200` status
  - added the required property `organization_id` to the response with the `200` status
  - added the required property `reset_sessions` to the response with the `200` status
  - added the required property `session_jwt` to the response with the `200` status
  - added the required property `session_token` to the response with the `200` status
- **2025-09-17** `8270cf3a3d4c`: 3 info
  - added the media type `application/json` for the response with the status `401`
  - added the media type `application/json` for the response with the status `500`
  - added the non-success response with the status `429`
- **2025-09-17** `864b9f438ac0`: 17 breaking
  - the `discovered_organizations/items/member_authenticated` response's property type changed from `string` to `boolean` for status `200`
  - the `discovered_organizations/items/membership/member/email_address_verified` response's property type changed from `string` to `boolean` for status `200`
  - the `discovered_organizations/items/membership/member/is_admin` response's property type changed from `string` to `boolean` for status `200`
  - the `discovered_organizations/items/membership/member/is_breakglass` response's property type changed from `string` to `boolean` for status `200`
  - the `discovered_organizations/items/membership/member/is_locked` response's property type changed from `string` to `boolean` for status `200`
  - the `discovered_organizations/items/membership/member/mfa_enrolled` response's property type changed from `string` to `boolean` for status `200`
  - the `discovered_organizations/items/membership/member/mfa_phone_number_verified` response's property type changed from `string` to `boolean` for status `200`
  - the `discovered_organizations/items/membership/member/scim_registration/scim_attributes/active` response's property type changed from `string` to `boolean` for status `200`
  - the `discovered_organizations/items/membership/member/scim_registration/scim_attributes/addresses/items/primary` response's property type changed from `string` to `boolean` for status `200`
  - the `discovered_organizations/items/membership/member/scim_registration/scim_attributes/emails/items/primary` response's property type changed from `string` to `boolean` for status `200`
  - the `discovered_organizations/items/membership/member/scim_registration/scim_attributes/entitlements/items/primary` response's property type changed from `string` to `boolean` for status `200`
  - the `discovered_organizations/items/membership/member/scim_registration/scim_attributes/ims/items/primary` response's property type changed from `string` to `boolean` for status `200`
  - the `discovered_organizations/items/membership/member/scim_registration/scim_attributes/phone_numbers/items/primary` response's property type changed from `string` to `boolean` for status `200`
  - the `discovered_organizations/items/membership/member/scim_registration/scim_attributes/photos/items/primary` response's property type changed from `string` to `boolean` for status `200`
  - the `discovered_organizations/items/membership/member/scim_registration/scim_attributes/roles/items/primary` response's property type changed from `string` to `boolean` for status `200`
  - the `discovered_organizations/items/membership/member/scim_registration/scim_attributes/x509certificates/items/primary` response's property type changed from `string` to `boolean` for status `200`
  - the `status_code` response's property type changed from `string` to `integer`, and format from no format to `int32` for status `200`

---

[Operation](https://skmtc.dev/stytch/apis/stytch-api/docs/v1/magic_links/authenticate/post.md) - [API](https://skmtc.dev/stytch/apis/stytch-api.md) - [Page](https://skmtc.dev/stytch/apis/stytch-api/changes/v1/magic_links/authenticate/post)